info
What comes with RithLaundry
Customer Application, Partner Application, and Admin Panel — all included.
Introduction
Welcome to RithLaundry, a modern on-demand laundry service platform designed to simplify the way users manage their laundry needs. The platform enables customers to browse laundry services and products, select preferred washing options, schedule pickups and deliveries, and place orders effortlessly through a user-friendly mobile application.
Core Features
- Subscription Plans
- Real-Time Order Tracking
- Zone Wise Service Management
- Quick & Convenient Pickup & Delivery
- Inclusive Support for RTL Languages
- Multi Service Booking
- Multi Address Order Management
- Call to Admin Option
- Push Notifications
- Master Settings
- Map (Routemappy tiles) rendering using MapLibre
check_circle
White-Label Solution
RithLaundry is delivered as a white-label platform, allowing businesses to customize branding, configurations, services, and operational workflows according to their business requirements.
Getting Started
warning
Third-Party Services Not Included
RithLaundry integrates with various third-party services to provide enhanced functionality. Please note that third-party services are not included in the base package and require separate paid subscriptions or licenses. These include but are not limited to:
- Map Services — Route planning, location tracking, and geocoding (e.g., MapLibre, Mapbox, Google Maps)
- Payment Gateways — Online payment processing and transaction handling (e.g., Stripe, Razorpay, PayPal)
- Push Notification Services — Real-time alerts and notifications (e.g., Firebase Cloud Messaging, OneSignal)
- Cloud Hosting & Storage — Server infrastructure, database hosting, and media storage (e.g., AWS, Google Cloud, Firebase)
- SMS & Email Services — Communication and verification services (e.g., Twilio, SendGrid)
Important: Clients are responsible for procuring and managing their own third-party service accounts and subscriptions. RithLaundry provides the integration framework only; service credentials, API keys, and associated costs are the client's responsibility.
lightbulb
Prerequisite Knowledge
Basic knowledge of mobile application deployment, server configuration, Firebase services, and third-party API integrations is recommended before installation and customization.
verified Version Requirements
Ensure the following software versions are installed before proceeding:
Backend Requirements
- PHP: 8.4 (exact version)
- Laravel: 11.x or later
- MySQL: 8.0
- Composer: 2.5 or later
- Apache/Nginx: Latest stable version
Frontend Requirements
- Node.js: v16.x or v18.x (LTS)
- npm: v8.x or later
- React: 18.3.1
- React Native: 0.77.1
- JavaScript Engine: Hermes
Android Development
- Android Studio: 2024.1.1 (Ladybug) or later
- Java JDK: 17 (Recommended)
- Android SDK: API Level 35 (Android 15)
- Build Tools: 36.0.0
- Gradle: 8.10.2
- Kotlin: 2.0.21
- Android NDK: 27.1.12297006
- Minimum Android SDK: 24
- Target Android SDK: 35
iOS Development (macOS only)
- Xcode: 16.x or later (from Mac App Store)
- iOS SDK: iOS 17+
- CocoaPods: 1.15.x or later
- macOS: Sonoma 14.5 or later
- iOS Deployment Target: iOS 13+
- Apple Developer Account: Required for distribution ($99/year)
warning
Important:
Using older versions may cause compatibility issues. Always use the recommended versions.
Software Requirements
Operating System:
- Windows 10/11 (64-bit)
- macOS Monterey or later
- Linux (Ubuntu 20.04+ or equivalent)
Minimum Hardware:
- Processor: Intel i5 (or AMD equivalent)
- RAM: 8 GB (minimum), 16 GB recommended
- Storage: 500 MB–2 GB of free disk space for dependencies and build files
Tool Requirements
| Tool/Software | Version | Purpose |
|---|---|---|
| Node.js | v16.x or v18.x (LTS) | Required to run React and npm scripts |
| npm | v8.x or later | Comes with Node.js |
| Git | Optional but recommended | For version control and some setups |
| Code Editor | VS Code (recommended) | For editing and running code |
| Browser | Latest Chrome, Firefox, or Edge | For testing the app |
XAMPP Installation
- Download XAMPP from apachefriends.org
- Install XAMPP on your system
- After installation, start Apache and MySQL servers from the XAMPP control panel
info
XAMPP Installation Guide:
Composer Installation
- Download Composer from getcomposer.org
- Install Composer on your system
info
Composer Installation Guide:
Getting Started Requirements
lightbulb
Note: It's necessary to have a basic knowledge in both server side and mobile app development.
- Basic knowledge in mobile application and installation
- Basic knowledge about Google Cloud and Firebase
terminal
Verify Your Installation
Run these commands in your terminal/command prompt to confirm all required tools are properly installed:
# Check Node.js version
node --version # Should show v16.x, v18.x or higher
# Check npm version
npm --version # Should show v8.x or higher
# Check PHP version
php --version # Should show 8.4
# Check Composer version
composer --version # Should show 2.5 or higher
# Check MySQL version
mysql --version # Should show 8.0 or higher
# Check Java version (for Android)
java --version # Should show 17
check_circle
Success Indicator:
If all commands show the correct versions (or higher), your environment is ready for installation.
error
Troubleshooting:
If any command returns "not found" or shows an older version, please install or update the corresponding software before proceeding.
Complete Technology Stack
RithLaundry is built using modern and scalable technologies to power customer applications, partner applications, and administrative operations.
code Core Technology Versions
Before installing and running the application, ensure the following technologies and tools are installed with the recommended versions.
React Native
0.77.1
React
18.3.1
Node.js
18+
PHP
8.4
Gradle
8.10.2
Kotlin
2.0.21
Android SDK
35
Android Build Tools
36.0.0
Min Android SDK
24
Target Android SDK
35
Android NDK
27.1.12297006
Java JDK
17
iOS Deployment Target
iOS 13+
JavaScript Engine
Hermes
| Category | Technology | Version | Purpose |
|---|---|---|---|
| Mobile Applications (Customer & Partner) | |||
| Framework | React Native | 0.77.1 | Cross-Platform Mobile Development |
| UI Library | React | 18.3.1 | Application User Interface |
| Navigation | React Navigation | Latest | Screen Navigation |
| State Management | Redux Toolkit | Latest | Application State Management |
| HTTP Client | Axios | Latest | API Communication |
| JavaScript Engine | Hermes | Latest | Performance Optimization |
| React Admin Panel | |||
| Framework | React | 18.3.1 | Admin Dashboard User Interface |
| Build Tool | Vite | Latest | Development & Production Build |
| Routing | React Router DOM | 6.x | Client-side Routing |
| HTTP Client | Axios | Latest | Backend API Communication |
| Icons | Lucide React | Latest | Dashboard Icons |
| Charts | Chart.js + React ChartJS 2 | Latest | Analytics & Reports |
| Notifications | React Toastify | Latest | Toast Notifications |
| Backend (Laravel API) | |||
| Language | PHP | 8.4 | Server-Side Programming |
| Framework | Laravel | 11.x | Backend API Framework |
| Database | MySQL | 8.0 | Relational Database |
| Dependency Manager | Composer | 2.5+ | PHP Package Management |
| HTTP Client | Guzzle HTTP | Latest | External API Communication |
| Firebase SDK | Kreait Firebase PHP | Latest | Firebase Services Integration |
| SMS Gateway | Twilio SDK | Latest | SMS & OTP Services |
| Android Development Environment | |||
| Node.js | Node.js | 18+ | JavaScript Runtime |
| Android SDK | Android SDK | 35 | Android Development Platform |
| Build Tools | Android Build Tools | 36.0.0 | Application Compilation |
| Minimum SDK | Android SDK | 24 | Minimum Supported Android Version |
| Target SDK | Android SDK | 35 | Target Android Version |
| Gradle | Gradle | 8.10.2 | Build Automation |
| Kotlin | Kotlin | 2.0.21 | Android Native Support |
| Android NDK | NDK | 27.1.12297006 | Native Library Support |
| Java | JDK | 17 | Android Development Environment |
| iOS Development Environment | |||
| iOS Deployment Target | iOS | 13+ | Minimum Supported iOS Version |
| Xcode | Xcode | 16.x+ | iOS Development Environment |
| CocoaPods | CocoaPods | 1.15.x+ | iOS Dependency Management |
| Third-Party Integrations | |||
| Push Notifications | Firebase Cloud Messaging | Latest | Real-Time Notifications |
| Authentication | Firebase Authentication | Latest | OTP Verification |
| Storage | Firebase Storage | Latest | Image & Document Uploads |
| Payment Gateway | Razorpay / Stripe | Latest | Online Payment Processing |
| Maps & Location | MapLibre / Mapbox | Latest | Location Services & Navigation |
Hosting & Production Server Requirements
- Apache 2.4+ or Nginx 1.18+
- PHP 8.4 (exact version)
- MySQL 8.0+
- SSL Certificate (HTTPS) Recommended
- Cron Job Support
- Minimum 4 GB RAM (8 GB Recommended)
- Minimum 10 GB Available Storage
Important:
Shared hosting, VPS, cloud servers, and dedicated servers are supported as long as the above requirements are met.
warning
Third-Party Services Not Included
RithLaundry integrates with various third-party services that require separate paid subscriptions. These include:
- Firebase Services — Push notifications, authentication, storage (paid beyond free tier)
- Payment Gateways — Razorpay, Stripe, or PayPal for online payments
- Map Services — MapLibre, Mapbox, or Google Maps for location tracking
- SMS Services — Twilio or similar for OTP and notifications
- Cloud Hosting — AWS, Google Cloud, or other hosting providers
Important: Clients are responsible for procuring and managing their own third-party service accounts, API keys, and subscriptions.
info
Important Note
Install all required SDKs, development tools, and dependencies using the recommended versions before beginning the installation process. Version mismatches may result in build or runtime issues.
Pro Tip: Use Node Version Manager (NVM) for Node.js version management and Android Studio SDK Manager for maintaining Android SDK compatibility.
hub Third Party Services
RithLaundry integrates with several third-party services to provide functionality such as maps, notifications, authentication, email delivery, and payment processing. These services are not included with the purchase package and must be configured using your own accounts and credentials where applicable.
| Service | Purpose | Required |
|---|---|---|
| MapLibre / RouteMappy Maps | Maps, Routing, Address Search & Location Services | Yes |
| Firebase Cloud Messaging (FCM) | Push Notifications | Yes |
| Firebase Authentication | OTP Verification & Authentication | Optional |
| Firebase Storage | Image & Document Uploads | Yes |
| SMTP Mail Service | Email Notifications, Password Reset & Verification | Yes |
| Twilio SMS | SMS Notifications & OTP Delivery | Optional |
| Razorpay | Online Payment Processing | Optional |
| Stripe | Online Payment Processing | Optional |
| PayPal | Online Payment Processing | Optional |
map Map Services
RithLaundry utilizes MapLibre for mapping and location services with RouteMappy tiles. This provides customizable mapping capabilities including route calculation, address search, navigation support, service area management, and location-based functionality.
If you require mapping services for your application, please contact the RouteMappy team directly.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
info
Note:
MapLibre is an open-source mapping library. RouteMappy tiles require a separate subscription or license.
cloud Firebase Services
RithLaundry uses Google Firebase for push notifications (FCM), authentication, and cloud storage. A Firebase project is required to enable these features.
- Website: https://firebase.google.com/
- Pricing: Free tier available with paid upgrades for higher usage
payments Payment Gateways
RithLaundry supports multiple payment gateways for online payments. Choose one or more based on your business requirements and region.
warning Important Notice
API keys, payment gateway accounts, SMS credits, email service providers, hosting services, domain registration, SSL certificates, and map service subscriptions or licensing fees are not included with the purchase package. Buyers are responsible for creating and maintaining their own third-party service accounts and subscriptions where applicable.
Project Dependencies Overview
RithLaundry consists of two mobile applications:
person
Customer App
For end-users to book laundry services
build
Partner App
For service providers to manage bookings
info
Common Base Version: React Native 0.85.3 with React 19.2.3
Node Engine: >= 22.11.0
Core Libraries
These libraries provide the core framework functionality and handle state management, navigation, API communication, and date processing.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| react | 19.2.3 | check_circle | check_circle | UI Library |
| react-native | 0.85.3 | check_circle | check_circle | Cross-platform mobile framework |
| react-redux | ^9.3.0 | check_circle | check_circle | State management |
| redux | ^5.0.1 | check_circle | check_circle | State container |
| axios | ^1.16.1 | check_circle | check_circle | HTTP client for API calls |
| moment | ^2.30.1 | check_circle | check_circle | Date and time formatting |
| i18next | ^26.3.0 | check_circle | check_circle | Internationalization |
| react-i18next | ^17.0.8 | check_circle | check_circle | React i18next integration |
Navigation Libraries
These libraries handle screen navigation, routing, and tab management within the applications.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| @react-navigation/native | ^7.2.4 | check_circle | check_circle | Core navigation library |
| @react-navigation/native-stack | ^7.15.1 | check_circle | check_circle | Stack navigation |
| @react-navigation/bottom-tabs | ^7.16.1 | check_circle | check_circle | Bottom tab navigation |
| @react-navigation/drawer | ^7.10.2 | check_circle | check_circle | Drawer/side menu navigation |
| @react-navigation/stack | ^7.9.2 | cancel | check_circle | Stack navigation (Partner only) |
| react-native-screens | ^4.25.2 | check_circle | check_circle | Native screen optimization |
| react-native-safe-area-context | ^5.5.2 | check_circle | check_circle | Safe area handling |
Maps and Location
These libraries enable map rendering and location tracking within the application.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| @maplibre/maplibre-react-native | ^10.2.1 | check_circle | check_circle | Map rendering (MapLibre) |
| react-native-maps | ^1.27.2 | check_circle | check_circle | Alternative map rendering |
| react-native-google-places-autocomplete | ^2.6.4 | check_circle | cancel | Google Places autocomplete (Customer only) |
| @react-native-community/geolocation | ^3.4.0 | check_circle | check_circle | GPS location services |
| react-native-android-location-enabler | ^3.0.1 | check_circle | check_circle | Android location services |
Firebase Services
Firebase is integrated to support real-time notifications and data synchronization.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| @react-native-firebase/app | ^24.0.0 | check_circle | check_circle | Firebase core |
| @react-native-firebase/database | ^24.0.0 | check_circle | check_circle | Real-time database |
| @react-native-firebase/messaging | ^24.0.0 | check_circle | check_circle | Push notifications |
| @notifee/react-native | ^9.1.8 | cancel | check_circle | Enhanced notifications (Partner only) |
UI and Animation Libraries
These libraries enhance the user interface and animation experience.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| react-native-reanimated | ^4.3.1 | check_circle | check_circle | Smooth animations |
| react-native-gesture-handler | ^2.31.2 | check_circle | check_circle | Gesture-based interactions |
| lottie-react-native | ^7.3.8 | check_circle | check_circle | Animated illustrations |
| react-native-paper | ^5.15.3 | check_circle | cancel | Material Design components (Customer only) |
| react-native-vector-icons | ^10.3.0 | check_circle | check_circle | Icon library |
| react-native-svg | ^15.15.5 | cancel | check_circle | SVG rendering (Partner only) |
| react-native-linear-gradient | ^2.8.3 | check_circle | check_circle | Gradient backgrounds |
| react-native-reanimated-carousel | ^4.0.3 | check_circle | check_circle | Carousel/slider component |
| react-native-animatable | ^1.4.0 | check_circle | cancel | Pre-built animations (Customer only) |
| react-native-drop-shadow | ^1.0.3 | check_circle | check_circle | Drop shadow effects |
| react-native-circular-progress | ^1.4.1 | cancel | check_circle | Circular progress indicators (Partner only) |
| deprecated-react-native-prop-types | ^5.0.0 | cancel | check_circle | Deprecated prop types (Partner only) |
Device Features
These libraries enable the application to interact with native device capabilities.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| react-native-image-picker | ^8.2.1 | check_circle | check_circle | Image selection from camera/gallery |
| react-native-fs | ^2.20.0 | check_circle | check_circle | File system access |
| react-native-haptic-feedback | ^3.0.0 | check_circle | cancel | Device vibration/haptic feedback (Customer only) |
| react-native-device-info | ^15.0.2 | check_circle | check_circle | Device information |
| @react-native-async-storage/async-storage | ^3.1.0 | check_circle | check_circle | Local data persistence |
| @react-native-community/netinfo | ^12.0.1 | check_circle | check_circle | Network connectivity monitoring |
| @react-native-community/datetimepicker | ^9.1.0 | cancel | check_circle | Date/time picker (Partner only) |
| @react-native-picker/picker | ^2.11.4 | check_circle | check_circle | Dropdown/picker component |
| react-native-fast-image | ^8.6.3 | check_circle | check_circle | Fast image loading |
| react-native-restart | ^0.0.27 (C) / ^0.0.28 (P) | check_circle | check_circle | App restart functionality |
Payment Integration
The application integrates multiple payment gateways to support secure online transactions.
| Package | Version | Customer | Partner | Purpose |
|---|---|---|---|---|
| react-native-razorpay | ^3.0.0 | check_circle | cancel | Razorpay payment gateway (Customer only) |
| flutterwave-react-native | ^1.0.4 | check_circle | check_circle | Flutterwave payment gateway |
| @stripe/stripe-react-native | ^0.66.0 | check_circle | cancel | Stripe payment gateway (Customer only) |
| react-native-paystack-webview | ^5.0.3 | check_circle | cancel | Paystack payment gateway (Customer only) |
Customer-Only Libraries
These libraries are specific to the Customer application.
| Package | Version | Purpose |
|---|---|---|
| react-native-animated-loader | ^1.0.0 | Animated loading indicators |
| react-native-app-intro-slider | ^4.0.4 | Onboarding/intro slides |
| react-native-dialog | ^9.3.0 | Dialog boxes |
| react-native-dialog-input | ^1.0.8 | Input dialog boxes |
| react-native-easy-content-loader | ^0.3.2 | Content loading placeholders |
| react-native-get-random-values | ^2.0.0 | Cryptographic random values |
| react-native-gifted-chat | ^3.3.3 | Chat/messaging interface |
| react-native-modal | ^14.0.0-rc.1 | Modal dialog components |
| react-native-pager-view | ^8.0.2 | Pager/swipe view |
| react-native-phone-input | ^1.3.7 | Phone number input with country codes |
| react-native-picker-select | ^9.3.1 | Picker select component |
| react-native-progress | ^5.0.1 | Progress bars and indicators |
| react-native-ratings | ^8.1.0 | Star rating component |
| react-native-raw-bottom-sheet | ^3.0.0 | Bottom sheet component |
| react-native-step-indicator | ^1.0.3 | Step indicator component |
| react-native-ui-stepper | ^1.2.4 | UI stepper component |
| toastify-react-native | ^7.2.3 | Toast notification messages |
Partner-Only Libraries
These libraries are specific to the Partner application.
| Package | Version | Purpose |
|---|---|---|
| react-native-app-intro-slider | ^4.0.4 | Onboarding/intro slides |
| react-native-phone-input | ^1.3.7 | Phone number input with country codes |
| react-native-ui-stepper | ^1.2.4 | UI stepper component |
Dependency Summary
person
Customer App:
- Total Dependencies: 65 packages
- Unique Libraries: 16 customer-only
- Base Version: React Native 0.85.3
- Node Engine: >= 22.11.0
build
Partner App:
- Total Dependencies: 51 packages
- Unique Libraries: 3 partner-only
- Base Version: React Native 0.85.3
- Node Engine: >= 22.11.0
check_circle Shared Libraries
person Customer Only
build Partner Only
Build Configuration
File Location: android/build.gradle
| Configuration | Value |
|---|---|
| Build Tools Version | 35.0.0 |
| Minimum SDK Version | 24 |
| Compile SDK Version | 35 |
| Target SDK Version | 35 |
| Android NDK Version | 27.1.12297006 |
| Kotlin Version | 2.0.21 |
Gradle Plugin Configuration
Gradle Plugins
classpath("com.android.tools.build:gradle:8.7.2")
classpath("com.facebook.react:react-native-gradle-plugin")
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin")
classpath 'com.google.gms:google-services:4.4.2'
How Customers Use the Application
1
Sign Up & Create Profile
- Download the RithLaundry Customer App from the provided link
- Tap on "Sign Up" or "Register" button
- Enter your full name, email address, and mobile number
- Create a secure password (minimum 8 characters)
- Verify your account via OTP sent to your mobile number
- Complete your profile
2
Login to Your Account
- Open the app and tap "Login" or "Sign In"
- Enter your registered mobile number and password
- After successful login, you will see the home screen with available services
3
Select Service Category
- From the home screen, browse available service categories:
- Dry Cleaning - Professional dry cleaning for delicate fabrics
- Ironing - Professional ironing and pressing services
- Wash & Iron - Complete washing and ironing service
- Washing - Standard washing service
- Select your preferred service category
- Choose the clothing category:
- Men - Shirts, T-shirts, Pants, Jeans, Suits, etc.
- Women - Dresses, Tops, Skirts, Sarees, etc.
- Kids - Children's clothing, School uniforms
- Browse available clothes items with:
- Item name and description
- Price per item
- Quantity selector
4
Add Items & Schedule Pickup
- Add items to your cart by selecting quantity for each item
- Review your cart summary with total price
- Before proceeding, select preferred pickup details:
- Select pickup date from available slots
- Select delivery date (estimated completion time)
- Choose preferred time slot
- Review all selections and tap "Proceed to Checkout"
5
Add Address & Place Order
- In the checkout screen, add delivery address:
- House/Flat number
- Street name and area
- City and landmark (optional)
- Add special instructions for the delivery partner (optional)
- Review your order summary:
- Items list with quantities
- Subtotal price
- Taxes and charges
- Total amount
- Apply promo codes if available
- Choose payment method:
- Card Payment
- UPI
- Net Banking
- Wallet
- Tap "Place Order" to confirm your booking
- You will receive a confirmation notification with order ID
6
Track Order Status
- View your order status in real-time:
- Pending - Order placed, waiting for admin confirmation
- Confirmed - Admin confirmed the order
- Partner Assigned - Delivery partner assigned for pickup
- Picked Up - Clothes picked up from your location
- Processing - Clothes being processed at laundry
- Ready for Dispatch - Clothes cleaned and ready
- Out for Delivery - Clothes being delivered back to you
- Delivered - Order delivered successfully
- Completed - Order completed
- Receive real-time In App notifications for status updates
lightbulb
Pro Tip: Save your addresses for faster future orders. Enable notifications to receive real-time order updates!
Partner App Workflow
1
Partner Registration
- Important: Partners are created by the Admin in the admin panel
- Admin adds partner details including:
- Full name and contact information
- Email address and phone number
- Delivery zone and service area
- Vehicle details (if applicable)
- Document verification (ID proof, address proof)
- Partner downloads the RithLaundry Partner App
- Partner logs in with provided credentials
2
Login to Partner App
- Open the app and tap "Login" or "Sign In"
- Enter your registered mobile number and password
- Upon successful login, you will see the partner dashboard
- Dashboard shows:
- Today's orders and status
- Pending pickups
- Pending deliveries
- Earnings summary
3
Receive & Accept Orders
- Admin allocates orders to available partners
- Partner receives order notification when assigned
- View order details:
- Customer name and contact
- Pickup address
- Delivery address
- Items list and quantity
- Special instructions (if any)
- Order value and commission
4
Pickup & Delivery Process
- Step 1: Pickup from Customer
- Navigate to customer's pickup address using live map
- Collect the clothes/items from customer
- Update status to "Picked Up"
- Customer receives notification
- Step 2: Deliver to Admin/Laundry
- Navigate to the admin/laundry location
- Drop off the clothes/items
- Admin verifies the items
- Update status to "Processing"
- Step 3: Collect from Admin/Laundry
- After admin finishes processing, receive "Ready for Dispatch" notification
- Navigate to admin/laundry location
- Collect the cleaned items
- Update status to "Out for Delivery"
- Step 4: Deliver to Customer
- Navigate to customer's delivery address
- Deliver the cleaned items to customer
- Get OTP verification (if enabled)
- Update status to "Delivered"
- Order moves to "Completed"
5
View Earnings & Withdrawals
- Go to "Earnings" section to view:
- Daily Earnings - Completed orders for today
- Transaction History - All past transactions
- Commission Breakdown - Admin commission details
- View detailed breakdown of each completed order
- Request withdrawal of your earnings to bank account
- Track withdrawal status (Pending → Approved → Completed)
6
Order History & Performance
- View order history with all past deliveries
info
Note: Partners must be registered and verified by the admin before they can start accepting orders. Maintain high service standards for better ratings and more order allocations!
Admin Panel Overview
The RithLaundry Admin Panel provides complete control over the platform. Below is the detailed menu structure and functionality with step-by-step workflows.
| Menu Section | Sub-Menu Items | Functionality |
|---|---|---|
| Dashboard | ||
| Dashboard | - | Overview of platform analytics, revenue, orders, and statistics |
| Settings | ||
| App Settings | - | Configure customer and partner app settings, features, and configurations |
| Map Settings | - | Configure map integration, location services, and API keys |
| Statuses | - | Manage order status options (Pending, Confirmed, Picked Up, Processing, Ready for Dispatch, Out for Delivery, Delivered, Completed) |
| Banner Images | - | Create and manage promotional banners for app home screen |
| Delivery Boy Reward Settings | - | Configure rewards and incentives for delivery partners |
| About Us | - | Manage About Us content displayed in the app |
| Customers | ||
| Customers | - | View and manage all registered customers |
| Customer Wallet Histories | - | View customer wallet transactions and balances |
| Feedbacks | - | View and respond to customer feedback and reviews |
| Users | ||
| Users | - | Manage admin users and their roles/permissions |
| Delivery Boys | - | Create, manage, and verify delivery partners. Assign roles and monitor performance |
| Orders | ||
| Orders | - | View and manage all customer orders. Allocate orders to delivery partners |
| Promo Codes | - | Create and manage promotional discount codes for customers |
| Products | ||
| Products | - | Manage laundry products and services (Dry Cleaning, Ironing, Wash & Iron, Washing) |
| Categories | - | Manage clothing categories (Men, Women, Kids) |
| Services | - | Manage service types and pricing |
| Locations | ||
| Cities | - | Manage cities where service is available |
| Areas | - | Manage areas within cities for service zones |
| Apartments | - | Manage apartments and buildings for delivery addresses |
| Payments | ||
| Payment Methods | - | Configure accepted payment methods (Card, UPI, Wallet, Net Banking) |
| Fare Managements | - | Manage service pricing, delivery charges, and commission rates |
| Subscriptions | ||
| Subscriptions | - | Create and manage subscription plans |
| Subscription Benefits | - | Manage benefits included in each subscription plan |
| Subscription Benefit Histories | - | View subscription benefit usage history |
| Customer Subscriptions | - | View and manage customer subscriptions |
| Content | ||
| Labels | - | Manage labels and translations for multi-language support |
| Notifications | - | Configure push notifications and templates |
| Code Masters | - | Manage code master data and configurations |
| Website | ||
| Website Setting | - | Configure website settings and content |
| Steps | - | Manage "How It Works" steps for website |
| Testimonials | - | Manage customer testimonials for website |
| Legal | ||
| Privacy Policies | - | Manage privacy policy content |
| Terms & Conditions | - | Manage terms and conditions content |
| Faqs | - | Create and manage FAQs for customers and partners |
| Filament Shield | ||
| Roles | - | Manage user roles and permissions (Super Admin, Admin, Manager, Delivery Boy) |
Key Admin Workflows
Delivery Partner Management
- Go to Users → Delivery Boys
- Click "Create" to add a new partner
- Fill in partner details (name, contact, address)
- Assign the "Delivery Boy" role
- Verify uploaded documents
- Approve/Activate the partner
- Partner receives login credentials automatically
Order Allocation Process
- Go to Orders → Orders
- View pending orders list
- Select an order and click "Assign Delivery Boy"
- Choose available partner from dropdown
- Partner receives notification immediately
- Order status updates to "Partner Assigned"
Order Management Flow
- Customer places order → Pending
- Admin confirms order → Confirmed
- Admin assigns partner → Partner Assigned
- Partner picks up clothes → Picked Up
- Partner delivers to admin → Processing
- Admin completes laundry → Ready for Dispatch
- Partner picks up from admin → Out for Delivery
- Partner delivers to customer → Delivered
- Order completed → Completed
Product & Category Management
- Go to Products → Categories to manage Men/Women/Kids
- Go to Products → Products to add laundry items
- Set product name, description, price, and category
- Go to Products → Services to manage service types
- Configure service names, descriptions, and pricing
- All changes reflect in customer app immediately
Location & Zone Management
- Go to Locations → Cities to add service cities
- Go to Locations → Areas to add areas within cities
- Go to Locations → Apartments to add buildings
- Organize delivery zones for efficient allocation
- Map settings can be configured in Settings → Map Settings
Subscription Plan Management
- Go to Subscriptions → Subscriptions
- Click "Create" to add a new subscription plan
- Set plan name, price, duration, and benefits
- Go to Subscriptions → Subscription Benefits
- Add benefits included in each plan
- View Customer Subscriptions to manage active subscriptions
admin_panel_settings
Access URL:
http://yourdomain.com/admin
Default Credentials: admin@gmail.com / admin
warning
Security Note: Change default admin password immediately after first login!
info
PHP Version Requirement
This admin panel requires PHP 8.4. Please ensure you have the correct version installed before proceeding.
php --version # Should show PHP 8.4.x
Installation Steps
-
1
Unzip the Source Folder
Extract the downloaded source files to your working directory.
-
2
Copy to XAMPP
Copy the admin folder and paste it inside
XAMPP → htdocs. Rename your project folder (e.g., RithLaundry_admin).infoVerify XAMPP & Composer: Ensure XAMPP and Composer are already installed. If not, download them from apachefriends.org and getcomposer.org. -
3
Open Command Prompt
Navigate to your project folder:
cd C:\xampp\htdocs\RithLaundry_admin -
4
Install Dependencies
Run the following command to install all PHP dependencies:
composer installWhen finished, verify the
vendorfolder has been created in your project. -
5
Create Database
Follow these steps in phpMyAdmin:
- Open
http://localhost/phpmyadminin your browser - Click "New"
- Enter your database name (e.g.,
rithlaundry_admin) - Click "Create"
- Open
-
6
Import Database
Import the SQL file located at
admin/db_file/Rithlaundry_admin.sqlusing phpMyAdmin:- In phpMyAdmin, select your newly created database
- Click the "Import" tab
- Choose the
Rithlaundry_admin.sqlfile from your project - Click "Go"
-
7
Generate Application Key
Run the following command to generate a unique application key:
php artisan key:generateinfoKey Generate: This command generates a unique application key that is used for encryption and security purposes. -
8
Configure .env File
If
.envfile is not visible, enable "show hidden files" in your system settings. Update the.envfile in your project root with the following settings:Application Settings
APP_URL=ENTER_YOUR_URL_HERE APP_ASSET_URL=ENTER_YOUR_URL_HERE/public/upload APP_ENV=production APP_DEBUG=falseDatabase Configuration
DB_DATABASE=your_database_name DB_USERNAME=your_db_username DB_PASSWORD=your_db_passwordTwilio SMS Settings
TWILIO_SID=your_twilio_sid TWILIO_TOKEN=your_twilio_token TWILIO_FROM=your_twilio_numberRazorpay Payment Gateway
RAZORPAY_KEY=your_razorpay_key RAZORPAY_SECRET=your_razorpay_secretFirebase Configuration
Firebase is required for push notifications, real-time database features, and other Firebase services. Before using the application, configure your own Firebase project.
Step 1: Download Firebase Service Account
- Open the Firebase Console.
- Select your Firebase Project.
- Go to Project Settings → Service Accounts.
- Click "Generate New Private Key".
- A JSON file will be downloaded (Example:
your-app-name-firebase-adminsdk.json).
Step 2: Upload the JSON File
Copy the downloaded Firebase JSON file into the following directory:
Admin/config/your-app-name.jsonStep 3: Update the .env File
FIREBASE_FILE=your-app-name.json FIREBASE_DB=https://your-project.firebaseio.com FCM_SERVER_KEY=your_fcm_server_key FCM_SENDER_ID=your_fcm_sender_idcheck_circleFirebase Connected
Once the JSON file is uploaded and the
.envvalues are updated, the application will automatically connect to your Firebase project.shieldSecurity Notice
Never share your Firebase Service Account JSON file or upload it to a public Git repository. This file contains sensitive credentials with administrative access to your Firebase project.
warningImportant: Replace all placeholder values with your actual credentials before running the application.
-
9
Run Migrations
Run the following command to create the database tables:
php artisan migrate -
10
Seed the Database
Run the following command to seed the database with default data:
php artisan db:seed --forceinfoThe--forceflag is used to run the seeder in production environments. For local development, you can omit it. -
11
Generate Shield Permissions
Run the following command to generate all Shield permissions:
php artisan shield:generate --all --option=permissions --panel=adminAfter generating permissions, run this command to assign the super admin role to your admin user:
php artisan tinker --execute=" \$role = DB::table('roles')->where('name','super_admin')->first(); \$perms = DB::table('permissions')->pluck('id')->toArray(); \$rows = array_map(fn(\$id) => ['permission_id'=>\$id,'role_id'=>\$role->id], \$perms); DB::table('role_has_permissions')->insertOrIgnore(\$rows); DB::table('model_has_roles')->insertOrIgnore(['role_id'=>1,'model_type'=>'App\\\Models\\\User','model_id'=>1]); echo 'Done: Admin assigned to super_admin role'; "infoShield: This generates all necessary permissions and assigns the super_admin role to the admin user (ID: 1). -
12
Optimize the Application
Run the following command to optimize the application for production:
php artisan optimize -
13
Serve Application
php artisan serveThe application will be available at
http://127.0.0.1:8000 -
14
Access Admin Panel
Open
http://127.0.0.1:8000in your browser.infoDemo Mode: The admin panel opens in demo mode by default. For full access, setAPP_ENV=productionandAPP_DEBUG=falsein your.envfile.
terminal Quick Command Reference
Run these commands in sequence to set up your admin panel:
# Step 1: Install dependencies
composer install
# Step 2: Generate application key
php artisan key:generate
# Step 3: Run migrations
php artisan migrate
# Step 4: Seed the database
php artisan db:seed --force
# Step 5: Optimize the application
php artisan optimize
# Step 6: Generate Shield permissions
php artisan shield:generate --all --option=permissions --panel=admin
# Step 7: Assign super admin role to admin user
php artisan tinker --execute="
\$role = DB::table('roles')->where('name','super_admin')->first();
\$perms = DB::table('permissions')->pluck('id')->toArray();
\$rows = array_map(fn(\$id) => ['permission_id'=>\$id,'role_id'=>\$role->id], \$perms);
DB::table('role_has_permissions')->insertOrIgnore(\$rows);
DB::table('model_has_roles')->insertOrIgnore(['role_id'=>1,'model_type'=>'App\\\Models\\\User','model_id'=>1]);
echo 'Done: Admin assigned to super_admin role';
"
# Step 8: Start the server
php artisan serve
Login Credentials
Use these default credentials to log in to the admin panel:
| Email: | admin@gmail.com |
| Password: | admin |
| Access Level: | Super Administrator |
shield
Security Alert: Change these credentials immediately after first login.
info
Project Type: React.js Single Page Application with Vite
Purpose: RithLaundry - Laundry Service Landing Page
Features: Responsive design, video hero, services showcase, admin panel, WhatsApp integration, app download links
Purpose: RithLaundry - Laundry Service Landing Page
Features: Responsive design, video hero, services showcase, admin panel, WhatsApp integration, app download links
System Requirements
Before installing, ensure your system meets these requirements:
Development Environment
- Node.js 18.x or above
- npm 9.x or above (or Yarn)
- VS Code (Recommended)
- Git (Optional)
Browser Support
- Chrome 90+
- Firefox 88+
- Edge 90+
- Safari 14+
- Mobile Browsers
Project Structure
rithlaundry-landing-page/
├── node_modules/
├── public/ # Static assets
│ └── vite.svg
├── src/
│ ├── assets/ # Images, icons, videos
│ │ ├── Herobg.webm # Hero background video
│ │ ├── Launderposter.webp # Video poster/thumbnail
│ │ └── Logo.webp # Company logo
│ ├── Components/ # Reusable UI components
│ │ ├── TranslateButton.jsx
│ ├── Data/ # Data files
│ │ └── data.js
│ ├── Landingpage/ # Main page component
│ │ └── Landingpage.jsx
│ ├── Theme/ # Theme configuration
│ │ ├── theme.js
│ │ └── ThemeContext.jsx
│ ├── api.js
│ ├── App.css
│ ├── App.jsx
│ ├── index.css
│ ├── main.jsx
├── eslint.config.js
├── index.html
├── package-lock.json
├── package.json
├── README.md
└── vite.config.js
Installation Steps
-
1
Extract the Project Files
Extract the downloaded ZIP file to your desired location.
infoRecommended: Extract to~/Projects/rithlaundry-landing-page/ -
2
Open Terminal in Project Folder
cd path/to/rithlaundry-landing-page -
3
Install Dependencies
Run npm install to install all required packages:
npm install -
4
Start Development Server
Launch the development server:
npm run devThe application will be available at
http://localhost:5173Admin Panel Access:
http://localhost:5173/admin
Admin Panel Guide
admin_panel_settings
Default Admin Credentials:
• Username:
• Password:
• Username:
admin@rithlaundry.com• Password:
admin123
Admin Panel Sections
1. App Details
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Title | App/company title |
| Description | Brief description of the app |
| Image | App logo or icon |
2. Website Settings
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Title | Website title |
| Description | Website description/meta description |
| Banner Image | Hero section background image |
| Playstore Link | Google Play Store app URL |
| Appstore Link | Apple App Store app URL |
| Store Image | App store mockup image |
| Store Title | Store section heading |
| Store Description | Store section description |
| Contact Link | WhatsApp/contact link |
| Website Color | Primary color for website |
| Facebook Link | Facebook page URL |
| Twitter Link | Twitter/X profile URL |
| Linkedin Link | LinkedIn company URL |
| Skype Link | Skype contact URL |
3. Features
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Title | Feature title |
| Description | Feature description |
| Image | Feature illustration/icon |
4. Steps (How It Works)
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Title | Step title |
| Description | Step description |
| Icon | Font Awesome icon class |
5. Our Achievements
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Count | Number/statistic value |
| Title | Achievement description |
6. Testimonials
| Field | Description |
|---|---|
| ID | Auto-generated unique identifier |
| Name | Customer/vendor name |
| Avatar | Profile image URL |
| Comments | Testimonial text |
| Role | Customer/vendor role |
Image Replacement Guide
All images are stored in src/assets/ folder:
| File Name | Purpose | Used In |
|---|---|---|
| Logo.webp | Company logo | Navbar, Footer |
| Herobg.webm | Hero background video | Hero Section |
| Launderposter.webp | Video poster/thumbnail | Hero Section |
image
How to replace: Replace the file in
src/assets/ with your own image. Keep the same filename to avoid updating imports, or update the import path in js data.js.
Available Scripts
| Command | Description |
|---|---|
npm run dev |
Start development server at localhost:5173 |
npm run build |
Build production-ready files in dist/ folder |
npm run preview |
Preview the production build locally |
npm run lint |
Run ESLint to check code quality |
Deployment Guide
1. Build for Production
npm run build
This creates a dist/ folder with optimized files.
2. Deploy to Hosting
- Vercel:
npx vercel --prod - Netlify: Drag and drop the
dist/folder - GitHub Pages: Deploy with
npm run buildand commit - AWS S3: Upload the
dist/folder to S3 bucket - Traditional Hosting: Upload via FTP to public_html
Common Issues & Solutions
❌ Node modules missing
Delete node_modules and package-lock.json, then run npm install again.
❌ npm command not found
Install Node.js from nodejs.org and restart your terminal.
❌ Images not loading
Check image paths in src/Data/js data.js. Ensure images are in src/assets/ folder.
❌ Video not playing
Check if Herobg.webm exists in src/assets/. Ensure the file is not corrupted.
❌ Port 5173 already in use
Run npm run dev -- --port 3000 to use a different port.
❌ CSS not updating
Clear browser cache (Ctrl+Shift+Delete) or use incognito mode.
❌ Admin panel not accessible
Check if .env file is configured properly.
Deployment Checklist
check_circle
All images are replaced with your own
check_circle
Content is updated in the admin panel
check_circle
Theme colors match your brand
check_circle
Links (social media, app stores) are correct
check_circle
.env file is configured
check_circle
Run
npm run build to create production build
check_circle
Upload
dist/ folder to hosting provider
rocket_launch
Ready to deploy? After completing the checklist, run
npm run build and upload the dist/ folder to your hosting provider.
Step 1: Install Node.js
Download and install Node.js from your browser by visiting the official website: https://nodejs.org/en/download
# Verify Node.js installation
node -v
npm -v
Step 2: Install Android Studio
Download and install Android Studio on your system from: https://developer.android.com/studio
Customer App Configuration
Step 1: Copy App Folder
Copy the customer folder and paste it into your desired location.
info
Note: If you rename the app folder, you must update the bundle ID.
Step 2: Change the Bundle ID
For Android, open:
folder_open Rithlaundry_customer/android/app/src/main/AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.Rithlaundry.customer">
...
</manifest>
Change the package attribute to your new bundle ID, for example:
package="com.mycompany.mycustomerapp"
For iOS, open:
folder_open ios/CustomerApp.xcodeproj
Update the Bundle Identifier under the app's target settings in Xcode.
check_circle
The bundle ID for the Rithlaundry Customer app has been successfully updated in your system. Follow the same process for other applications.
Changing App Name
folder_open Rithlaundry/android/app/src/main/res/values/strings.xml
<!-- In strings.xml -->
<string name="app_name">Your App Name</string>
Changing App Icon
- Replace all icon files in
res/mipmap-*directories - Update adaptive icons in
res/mipmap-anydpi-v26 - Rebuild your app
Android Configuration
folder_open Rithlaundry/android/app/build.gradle
// In app/build.gradle
android {
defaultConfig {
applicationId "com.yourcompany.yourapp"
}
}
warning
Warning: Changing package name after release will be treated as a new app by Google Play.
If you need additional features, modifications, or integrations in this application, we offer custom development services to tailor the app to your specific needs.
For any custom work requests, please get in touch with us:
- language Website: https://menpanitech.com/
- mail Email: sales@menpanitech.com
info
Note: Custom work may involve additional costs and development time depending on the complexity of the requested changes.
history Version History
Track the evolution of the RithLaundry platform through major releases, feature additions, improvements, and optimizations.
new_releases
Version 1.0.0
Latest Release
calendar_today
July 2026
-
bug_report
Minor Bug Fixing
Fixed various bugs and issues reported in the initial release for improved stability and performance across all platforms.
-
dark_mode
Dark & Light Mode Support
Added complete dark mode and light mode support across customer and partner applications with seamless theme switching.
-
map
Custom Map Implementation
Implemented own custom map rendering using MapLibre with RouteMappy tiles for address search, location services, route optimization, and service area management.
-
payments
Payment Gateway Integration
Integrated Paystack and Flutterwave payment gateways for secure online payment processing.
devices
3 Platforms
Customer App, Partner App, Admin Panel
check_circle
4+ Services
Dry Cleaning, Ironing, Wash & Iron, Washing
payments
2 Payment Gateways
Paystack & Flutterwave Integrated
info Release Notes
- Version 1.0.0: First stable production release with all core features including dark/light mode, custom map implementation, and Paystack & Flutterwave payment gateways.
Admin Panel Configuration
Project Setup
- Go to Firebase Console and create a new project
- Create a web app in your Firebase project
Database Configuration
- Navigate to your project dashboard and create the Database
Service Account Setup
- Go to Settings → Project settings → Advanced permissions settings
- Click on "Service Accounts" under Firebase Admin SDK section
- Click "Actions" → "Manage Keys" → "Add Key" → "Create new key"
- Select JSON format and click "Create"
.env Configuration
FIREBASE_CREDENTIALS=firebase.json
FIREBASE_DATABASE_URL=https://your-project-id.firebaseio.com
folder
Place the JSON file in: /admin/config/firebase.json
Mobile App Configuration
Android Setup
- Select your existing project in Firebase Console
- Click Settings icon → Project settings → Add app → Android
- Download
google-services.jsonfile - Place the file in:
Rithlaundry_customer/android/app
info
If you haven't created a Firebase project yet, follow the Admin Configuration steps above first.
Required Firebase Services
admin_panel_settings
Authentication
database
Realtime Database
cloud
Cloud Firestore
notifications
Cloud Messaging
analytics
Analytics
location_on
Geo Locations
Clients must update the bundle identifier to match their application package.
Example: com.clientname.Rithlaundry
Android
Update in:
folder_open android/app/build.gradle
applicationId "com.clientname.Rithlaundry"
Rename the Java package directory:
folder_open android/app/src/main/java/com/clientname/Rithlaundry
Generate a signing keystore:
keytool -genkey -v \
-keystore Rithlaundry.keystore \
-alias Rithlaundry \
-keyalg RSA \
-keysize 2048 \
-validity 10000
Place the keystore file inside:
folder_open android/app/
Update the signing configuration in:
folder_open android/gradle.properties
MYAPP_UPLOAD_STORE_FILE=Rithlaundry.keystore
MYAPP_UPLOAD_KEY_ALIAS=Rithlaundry
MYAPP_UPLOAD_STORE_PASSWORD=yourpassword
MYAPP_UPLOAD_KEY_PASSWORD=yourpassword
Generate APK
cd android
./gradlew assembleReleaseAPK location: android/app/build/outputs/apk/release/app-release.apk
Generate Play Store Bundle
cd android
./gradlew bundleReleaseOutput: android/app/build/outputs/bundle/release/app-release.aab
iOS development requires a macOS system with Apple Xcode installed. Xcode provides all necessary tools, simulators, and SDKs required to build and run the application on iOS devices.
Ensure that you have the latest version of Xcode installed from the Mac App Store and have accepted all license agreements before proceeding.
The iOS project uses CocoaPods to manage native dependencies. You must install all required pods before running the application.
Follow the steps below:
cd ios
pod install
cd ..
This command installs all required native libraries and links them with your iOS project.
Firebase is used for push notifications and other backend services. You need to download and configure the Firebase iOS configuration file.
Step 1: Download Configuration File
GoogleService-Info.plist
Step 2: Add File to Project
Place the downloaded file inside the following directory:
folder_open ios/Rithlaundry/GoogleService-Info.plist
Steps in Xcode:
- Open the iOS project in Xcode.
- Drag and drop the
GoogleService-Info.plistfile into the Project Navigator. - Select "Copy items if needed" when prompted.
- Ensure the file is added to the main application target.
This configuration enables Firebase services such as push notifications and analytics.
The Bundle Identifier uniquely identifies your application in the Apple ecosystem. It must match the identifier configured in Firebase and Apple Developer account.
Steps:
- Open the project in Xcode:
ios/Rithlaundry.xcworkspace - Select the main application target.
- Go to the General tab.
- Update the Bundle Identifier field.
Example: com.clientname.taxiapp
Ensure that the Bundle Identifier matches exactly with the one used in the Firebase configuration file, otherwise services may not work correctly.
Application icons are used across the app, App Store, and device home screen. You need to replace the default icons with your branding assets.
App Icon Path:
folder_open ios/Rithlaundry/Images.xcassets/AppIcon.appiconset
Replace all icon sizes inside this folder with your custom icons while maintaining the required dimensions.
iOS App Logo
Replace the main logo used inside the application UI:
folder_open src/assets/logo.png
Recommended size: 500 × 500 PNG (transparent background preferred)
Before running the application, make sure the Metro bundler is running.
Step 1: Start Metro Server
npm start
Step 2: Run iOS App
npx react-native run-ios
This command will build the app and launch it in the iOS Simulator. Alternatively, you can open the project in Xcode and run it directly on a simulator or a physical device.
To publish your application to the App Store, you must generate a release build using Xcode.
Steps:
- Open the project in Xcode:
ios/Rithlaundry.xcworkspace - Select Generic iOS Device as the build target.
- From the top menu, select Product → Archive.
- Once the archive is created, open the Organizer window.
- Validate and upload the build to App Store Connect.
After uploading, you can manage your app release from App Store Connect.
Application API configuration is located in:
folder_open src/config/const.js
Update the following values with client server details:
- BASE_URL
- API_URL
- IMG_URL
- SOCKET_URL (if applicable)
Example:
export const BASE_URL = "https://api.clientdomain.com"
export const API_URL = "https://api.clientdomain.com"
export const IMG_URL = "https://cdn.clientdomain.com"
Application Logo
Replace the logo file located at:
folder_open src/assets/logo.png
Recommended format: 500 × 500 PNG
Android Launcher Icons
Replace launcher icons in:
folder_open android/app/src/main/res/
Folders:
- mipmap-mdpi
- mipmap-hdpi
- mipmap-xhdpi
- mipmap-xxhdpi
- mipmap-xxxhdpi
iOS App Icons
Replace icons in:
folder_open ios/Rithlaundry/Images.xcassets/AppIcon.appiconset
The application uses MapLibre for map rendering and location-based services.
Map Library Used
@maplibre/maplibre-react-native
Capabilities
layers
Vector Tile Rendering using RouteMappy tiles
map
Real-time map display for ride tracking
navigation
Location-based services for navigation and route visualization
bolt
High-performance map rendering optimized for mobile devices
These features enable the application to display locations, trip routes, and navigation paths within the app.
Admin Panel Configuration
Step 1: Enter Your RouteMappy API Key
In the place of enter_map_key in your .env file, add your RouteMappy API key as shown below:
MAP_KEY=enter_map_key
info
If you need RouteMappy Maps for your application, feel free to contact us. It functions as a customizable map solution, available for purchase.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
Mobile Application Configuration
Step 1: Add Your API Key
Edit the following file:
folder_open Rithlaundry/src/config/Constants.js
export const ROUTEMAPPY_API_KEY = 'enter_your_routemappy_key';
info
If you need RouteMappy Maps for your application, feel free to contact us. It functions as a customizable map solution, available for purchase.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
Library Used
- react-native-razorpay
- flutterwave-react-native
Features
lock
Secure online payments
directions_car
Ride fare payments
credit_card
Multiple payment methods (Cards, UPI, Net Banking, Wallets)
Configuration
Payment credentials must be configured on the backend server to enable transaction processing.
Required credentials typically include:
- Payment Gateway API Key
- Secret Key
- Webhook configuration for transaction validation
These credentials are used by the backend API to securely communicate with the payment gateway.
warning
Important Warning
Sensitive credentials such as secret keys must never be stored in the mobile application. All payment validation and transaction verification should be handled securely through the backend server.
Modern FCM v1 Setup (OAuth 2.0)
This guide covers the modern Firebase Cloud Messaging v1 API. It uses OAuth 2.0 for secure authentication and provides more features than the deprecated legacy API.
warning
Important
The legacy FCM HTTP API (using Server Keys) is deprecated and will be removed. Always use the Firebase Cloud Messaging HTTP v1 API for all new implementations.
Step 1: Generate Service Account Credentials
-
Access Firebase Console
Go to Firebase Console and select your project.
Navigate to Project Settings (gear icon) → Service accounts tab.
-
Generate a new private key
Click "Generate new private key" in the Firebase Admin SDK section.
Confirm by clicking "Generate key" in the popup.
A JSON file (
your-project-id-firebase-adminsdk.json) will be downloaded automatically. This file contains your service account credentials.shield Security Keep this file secure. It contains sensitive credentials that provide full access to your Firebase services. Never commit this file to a public repository or share it with unauthorized users.
Step 2: Server-Side Configuration
Place the Service Account File
Copy the downloaded JSON file to your project's secure configuration directory:
folder
Recommended Location: /admin/config/firebase-service-account.json
Configure Environment Variables
Update your backend .env file with the following configuration:
# Firebase Cloud Messaging v1 Configuration
FIREBASE_PROJECT_ID=your-project-id
FCM_DRIVE_PATH=/path/to/firebase-service-account.json
info
Note
The FCM_DRIVE_PATH points to your Firebase Service Account JSON file, and
FIREBASE_PROJECT_ID is your Firebase project identifier, which can be found in the Firebase Console.
Step 3: Sending Notifications with v1 API
Here's a secure implementation example for sending push notifications using the FCM v1 API with OAuth 2.0 authentication:
// FCM v1 API Notification Sender
// Uses OAuth 2.0 authentication with service account
use Google\Cloud\Firestore\FirestoreClient;
use Google\Cloud\Core\ServiceBuilder;
// Initialize Firebase with service account
$firestore = new FirestoreClient([
'keyFilePath' => env('FCM_DRIVE_PATH'),
'projectId' => env('FIREBASE_PROJECT_ID')
]);
// Construct the FCM v1 endpoint
$url = "https://fcm.googleapis.com/v1/projects/" . env('FIREBASE_PROJECT_ID') . "/messages:send";
// Get OAuth 2.0 access token
$token = $firestore->getCredentialsFetcher()?->fetchAuthToken();
$accessToken = $token['access_token'];
// Construct the notification payload (v1 format)
$data = [
"message" => [
"token" => "device_registration_token_here",
"notification" => [
"title" => "Notification Title",
"body" => "Notification Message Body"
],
"data" => [
"key1" => "value1",
"key2" => "value2"
],
"android" => [
"priority" => "high"
],
"apns" => [
"headers" => [
"apns-priority" => "10"
]
]
]
];
// Send the notification
$options = [
'http' => [
'header' => "Authorization: Bearer $accessToken\r\n" .
"Content-Type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
Troubleshooting
Common Issues:
-
Authentication Failed (401):
Verify the service account JSON file path is correct and the file has proper read permissions. Ensure the project ID matches.
-
Invalid Token (404):
The device registration token may be invalid or expired. Request a new token from the client app.
-
Permission Denied (403):
The service account needs the "Firebase Cloud Messaging Admin" role in IAM settings.
check_circle
Success
The modern FCM HTTP v1 API provides enhanced security, improved reliability, and supports all the latest Firebase Cloud Messaging features.
Step-by-Step Configuration
-
Step 1: Access Gmail Account Settings
Log in to your Gmail account and click on your profile picture in the top right corner. Select "Manage your Google Account" from the dropdown menu.
-
Step 2: Enable Security Verification
Navigate to the "Security" tab in the left sidebar.
Under "Signing in to Google," enable 2-Step Verification if not already active.
infoNote: You must have 2-Step Verification enabled to generate an App Password.
-
Step 3: Generate App Password
While still in the Security section:
-
Find the "App passwords" option (under 2-Step Verification)
-
Click "create"
-
Copy the 16-character password shown
-
.env File Configuration
Add these configurations to your .env file:
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=youremail@gmail.com
MAIL_PASSWORD=your_generated_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=youremail@gmail.com
MAIL_FROM_NAME="${APP_NAME}"
warning
Important Security Notes:
- Never use your main Gmail password in the .env file
- Always use the generated App Password
- Keep your .env file secure and never commit it to version control
- If compromised, revoke the app password immediately from Google Security settings
Troubleshooting
Common Issues:
-
Authentication Failed:
Verify 2-Step Verification is enabled and you're using an App Password.
-
Connection Timeout:
Check if your server/firewall allows outbound connections on port 587.
-
Daily Limit Exceeded:
Gmail has sending limits (500 emails/day for free accounts).
Application Deployment Guide
info
Advisable: Copy the source files to D: or E: drive rather than C: drive.
Environment Setup
- Connect your device via USB
- Verify connection:
adb devicesConfirm the device appears in the list.
check_circle
Prerequisites
- Android Studio with SDKs installed
- Active emulator/device visible via adb
- Developer options enabled on physical devices
Build & Run Process
- Launch Command Prompt
- Navigate to project directory:
cd D:\Rithlaundry_customer- Install project dependencies:
npm install- Execute the application:
npx react-native run-androidFAQ & Troubleshooting
1. Installation Dependencies Failed (composer install or npm install)
Cause: Missing or outdated PHP/Node.js version, unstable internet connection, or running commands from the wrong directory.
Solution:
- Ensure PHP 8.4 and Node.js are installed and updated to the recommended version.
- Open terminal inside the project root directory.
- Run:
composer install- If the issue persists for npm:
rm -rf node_modules package-lock.json
npm install2. Module Not Found Error
Cause: Missing dependencies, incorrect import paths, or incomplete project extraction.
Solution:
- Verify all project files are extracted correctly.
- Check import paths.
- Reinstall dependencies:
composer install- Restart the development server.
3. Firebase Configuration Issues
Cause: Firebase project setup is incomplete or configuration files are missing.
Solution:
- Verify Firebase project settings.
- Download and configure:
google-services.json(Android)GoogleService-Info.plist(iOS)
- Ensure Firebase Cloud Messaging (FCM) is enabled.
- Verify package names and bundle identifiers match Firebase configuration.
- Check
.envfile has all Firebase credentials configured.
4. Environment Variables Not Configured
Cause: Missing or incomplete environment configuration.
Solution:
- Copy the sample environment file.
- Rename it to
.env. - Configure all required values including:
APP_URL=https://your-domain.com
DB_DATABASE=your_database_name
DB_USERNAME=your_db_username
DB_PASSWORD=your_db_password- Restart the application after updating environment variables.
5. Android Device Not Detected
Cause: USB debugging is disabled or device drivers are not installed.
Solution:
- Enable Developer Options.
- Enable USB Debugging.
- Connect the device using a supported USB cable.
- Verify detection:
adb devices- Accept the authorization prompt on the device.
6. License or Purchase Code Validation Issues
Cause: Invalid, missing, or incorrectly entered Envato purchase code.
Solution:
- Login to your Envato account.
- Navigate to Downloads.
- Download the License Certificate & Purchase Code.
- Copy the purchase code and enter it correctly.
7. Application Not Loading After Installation
Cause: Missing configuration, incorrect API URL, or application initialization errors.
Solution:
- Verify API configuration in
.envfile. - Check environment variables.
- Verify backend server is running.
- Review console logs for detailed errors.
- Clear application cache and rebuild.
8. Admin Panel Database Import Issues
Cause: Incorrect database credentials or failed SQL import.
Solution:
- Create a new database in phpMyAdmin.
- Import the provided SQL file (
Rithlaundry_admin.sql). - Update database credentials in the
.envfile. - Verify database connection settings.
- Run migrations if needed:
php artisan migrate
9. Push Notifications Not Working
Cause: Firebase Cloud Messaging (FCM) is not configured properly.
Solution:
- Verify Firebase project configuration.
- Confirm FCM Server Key is configured in
.env. - Ensure notification permissions are granted on the device.
- Test notifications from:
Admin Panel → Settings → FCM Notifications
- Verify device internet connectivity.
10. Map Not Displaying
Cause: MapLibre/RouteMappy configuration is incomplete or map services are unavailable.
Solution:
- Verify MapLibre/RouteMappy configuration settings.
- Check internet connectivity.
- Confirm location permissions are enabled.
- Verify map settings from:
Admin Panel → Settings → Map Settings
- Contact RouteMappy support if API access or licensing assistance is required.
11. Delivery Partner Registration Remains Pending
Cause: Partner account is awaiting administrator approval.
Solution:
- Login to Admin Panel.
- Navigate to:
Users → Delivery Boys
- Review partner details and make status as active.
12. Payment Gateway Not Working
Cause: Payment credentials are incorrect or payment methods are disabled.
Solution:
- Verify payment gateway credentials in
.env. - Confirm gateway status is enabled.
- Check configuration under:
Admin Panel → Payments → Payment Methods
- Test using sandbox credentials before going live.
13. OTP Verification Not Received
Cause: SMS service provider configuration is incomplete or delayed.
Solution:
- Verify SMS gateway credentials (Twilio) in
.env. - Confirm mobile number format is correct.
- Check SMS provider balance and status.
- Retry OTP after a few minutes.
14. Customer or Partner Unable to Login
Cause: Incorrect credentials, inactive account, or account suspension.
Solution:
- Verify registered mobile number or email.
- Reset password using the Forgot Password option.
- Ensure account status is active in Admin Panel.
- For partners, verify they have been created and approved by admin.
- Verify OTP services are functioning properly.
15. Images or Banners Not Uploading
Cause: File size exceeds server limits or unsupported file format.
Solution:
- Upload supported image formats (JPG, PNG, WEBP).
- Reduce image size.
- Verify upload permissions on the server.
- Check storage availability.
16. Orders Not Appearing for Delivery Partners
Cause: Partner is not assigned to the order, or partner status is inactive.
Solution:
- Verify partner account is approved and active.
- Check if admin has assigned the order to the partner.
- Admin can assign orders from:
Admin Panel → Orders → Orders → Assign Delivery Boy
- Confirm partner is online and available.
- Verify partner's service area coverage.
17. Admin Panel Login Failed
Cause: Incorrect credentials or database connection issue.
Solution:
- Verify email:
admin@gmail.comand password:admin. - Check database connection in
.envfile. - Ensure database has been seeded correctly.
- If you have run
php artisan shield:generate, ensure super admin role is assigned. - Clear application cache:
php artisan optimize:clear
18. Subscription Plans Not Displaying
Cause: Subscription plans are not created or are inactive.
Solution:
- Go to Admin Panel:
Admin Panel → Subscriptions → Subscriptions
- Create a new subscription plan or activate existing.
- Add benefits under:
Admin Panel → Subscriptions → Subscription Benefits
support_agent Need Additional Help?
If you encounter any issues that are not covered in this documentation, please contact our support team.
Support Email:
Support Hours:
Monday – Friday
Response Time: Within 24–48 Business Hours
Please include the following information when contacting support:
- Purchase Code
- Application Version
- Server Information
- Error Screenshot (if available)
- Detailed Issue Description
This will help us provide faster and more accurate assistance.
support_agent
Need Help?
If you encounter an error that is not listed above, please feel free to contact our support team for further assistance. We’re here to help.
Custom Development Services
If you need any custom work, additional features, or modifications to this application, our team is ready to help you build and scale your project efficiently.
What We Can Help With
code
Custom feature development based on your business needs
palette
UI/UX design improvements and branding customization
integration_instructions
Third-party API integrations (payment, SMS, maps, etc.)
speed
Performance optimization and scalability improvements
cloud_upload
Full project setup and deployment assistance
rocket_launch
Building large-scale applications from scratch
Hire Us
You can hire our development team for complete project development, from idea to deployment, including frontend, backend, and server setup.
call
Phone Number
+91 9150 441 443
language
Website
https://menpanitech.com/
mail
Email
sales@menpanitech.com
info
Important Note
Custom development services may involve additional cost and timeline depending on the scope and complexity of the project.
We’re happy to collaborate and bring your ideas to life