A next-generation local business directory platform specifically designed for Gangtok, Sikkim - serving as an advanced alternative to JustDial with modern UI/UX and comprehensive business management features.
Easy Life Gangtok is a comprehensive digital platform that bridges the gap between local businesses and customers in Sikkim's capital. Built with modern React architecture and featuring an intuitive admin panel, multi-role authentication, and real-time business management capabilities, this platform revolutionizes how locals discover and connect with service providers.
- Hyper-Local Focus: Specifically designed for Gangtok's unique geography and business ecosystem
- Multi-Role Architecture: Comprehensive dashboards for customers, business owners, and administrators
- Advanced Business Verification: Multi-stage approval workflow with document verification
- Real-time Analytics: Business performance tracking and customer insights
- Mobile-First Design: Optimized for the mobile-centric audience of Sikkim
- Complete Business Profiles: Detailed listings with photos, services, pricing, and operating hours
- Multi-Stage Verification: Pending → Under Review → Approved workflow with document validation
- Business Analytics Dashboard: Revenue tracking, customer inquiries, and performance metrics
- Dynamic Pricing Management: Flexible pricing display for different service categories
- Review & Rating System: Customer feedback management with response capabilities
- Smart Search & Filtering: Advanced search with category, location, and rating filters
- Interactive Category Grid: 30+ service categories from electricians to restaurants
- Real-time Recommendations: AI-driven suggestions based on user behavior
- Mobile-Optimized Interface: Responsive design for all device types
- Geolocation Integration: Location-based service discovery
- Multi-Role System: Customer, Business Owner, and Administrator roles
- OTP-Based Login: Secure phone number verification
- Session Management: Persistent login with localStorage integration
- Role-Based Access Control: Granular permissions for different user types
- Comprehensive Admin Panel: Full platform control and monitoring
- Business Lifecycle Management: From application to approval and ongoing management
- User Management: Customer and business owner account administration
- Settlement & Commission Tracking: Financial management and payment processing
- System Configuration: Website-wide settings and feature toggles
React 18.3.1 - Modern component-based UI framework
TypeScript 5.5.3 - Type-safe JavaScript development
Vite 5.4.2 - Next-generation build tool
TailwindCSS 3.4.1 - Utility-first CSS framework
Framer Motion 11.3.0 - Advanced animations and transitions
React Router DOM 6.26 - Client-side routing and navigation
React Helmet Async - SEO and meta tag management
Recharts 2.12.7 - Data visualization and analytics
Lucide React - Modern icon library
ESLint 9.9.1 - Code quality and style enforcement
TypeScript ESLint - TypeScript-specific linting rules
PostCSS 8.4.35 - CSS processing and optimization
Autoprefixer 10.4.18 - Cross-browser CSS compatibility
src/
├── components/ # Reusable UI components
│ ├── admin/ # Administrative interface components
│ ├── common/ # Shared components (Button, Card, Input, Modal)
│ ├── home/ # Homepage-specific components
│ ├── layout/ # Layout components (Navbar, Footer)
│ ├── listings/ # Business listing components
│ └── seller/ # Business owner dashboard components
├── context/ # React Context for state management
│ ├── AuthContext.jsx # Authentication state management
│ ├── HomepageConfigContext.jsx # Homepage configuration
│ └── WebsiteConfigContext.jsx # Global website settings
├── data/ # Static data and mock APIs
│ ├── businesses.js # Business listings database
│ ├── categories.js # Service categories and subcategories
│ └── users.js # User accounts and authentication data
├── pages/ # Route-level page components
└── App.jsx # Main application component with routing
- Node.js 18.0.0 or higher
- npm or yarn package manager
- Git for version control
-
Clone the Repository
git clone https://github.com/kunaldevelopers/Easy-Life.git cd Easy-Life -
Install Dependencies
npm install
-
Environment Configuration
# Create environment file cp .env.example .env.local # Configure environment variables VITE_APP_NAME="Easy Life Gangtok" VITE_API_BASE_URL="http://localhost:3000/api" VITE_MAPS_API_KEY="your_google_maps_api_key"
-
Start Development Server
npm run dev
-
Build for Production
npm run build
# Code linting
npm run lint
# Type checking
npx tsc --noEmit
# Build verification
npm run build && npm run preview- Home Services: Electrician, Plumber, Carpenter, Painter, CCTV Services
- Personal Care: Barber, Masseur, Babysitter, Nurse
- Transportation: Taxi Services, Bike Rental, Two-Wheeler Services
- Hospitality: Hotels, Restaurants, Food Delivery
- Shopping: Groceries, Pharmacy, Gadgets, Clothes, Books
- Real Estate: Room Rent, Land, Lease Flats
- Specialized Services: Electronic Repair, Raj Mistiri, Sweepers
- Service discovery and booking
- Review and rating management
- Inquiry tracking and communication
- Favorite businesses and saved searches
- Order history and service tracking
- Complete business profile management
- Customer inquiry management
- Analytics and performance tracking
- Photo and service portfolio management
- Business hours and availability settings
- Financial tracking and commission management
- Business Management: Approve, reject, or request modifications
- User Administration: Manage customer and business accounts
- Content Moderation: Review and moderate business content
- Financial Oversight: Commission tracking and settlement management
- System Configuration: Platform settings and feature management
- Analytics Dashboard: Platform-wide metrics and insights
{
id: "unique_identifier",
name: "Business Name",
category: "services|advertisements",
subcategory: "electrician|plumber|restaurant|hotel",
description: "Detailed business description",
rating: 4.8,
reviewCount: 156,
location: "Area within Gangtok",
address: "Complete business address",
contact: {
phone: "+91 XXXXXXXXXX",
whatsapp: "+91 XXXXXXXXXX",
email: "business@email.com",
website: "https://website.com"
},
operatingHours: {
monday: "9:00 AM - 6:00 PM",
// ... other days
},
services: ["Service 1", "Service 2"],
pricing: "₹200 - ₹5000",
images: ["image1.jpg", "image2.jpg"],
verified: true,
tags: ["Expert", "Trusted", "24/7"],
coordinates: { lat: 27.3314, lng: 88.6138 }
}{
id: "user_id",
name: "User Name",
email: "user@email.com",
phone: "+91 XXXXXXXXXX",
type: "customer|seller|admin",
verified: true,
businessId: "linked_business_id", // for sellers
joinDate: "2024-01-01",
avatar: "avatar_url"
}- RESTful API Design: Comprehensive endpoints for all platform operations
- Database Design: MongoDB/PostgreSQL for scalable data management
- Authentication Service: JWT-based secure authentication
- File Upload System: Image and document management for businesses
- Payment Gateway: Integrated commission and subscription management
- Notification System: Real-time updates and communication
- Search Engine: Advanced search with filters and recommendations
- Analytics Service: Business intelligence and reporting
- Real-time business verification workflow
- Automated commission calculation and settlement
- Advanced search with geolocation and AI recommendations
- Customer-business communication system
- Review and rating management with moderation
- Business analytics and reporting dashboard
- Payment integration for premium listings
- Mobile app API support
- Modern UI/UX: Contemporary design with smooth animations
- Local Focus: Specifically designed for Gangtok's market needs
- Real-time Updates: Instant business information updates
- Advanced Filtering: Sophisticated search and discovery options
- Mobile-First: Optimized for mobile users in the region
- Comprehensive Admin Tools: Advanced business management capabilities
- Performance Optimized: Fast loading with code splitting and lazy loading
- SEO Ready: Meta tag management and search engine optimization
- Accessibility: WCAG compliant design for all users
- Scalable Architecture: Designed for future growth and feature additions
- Type Safety: TypeScript implementation for robust code quality
- Frontend: Vercel, Netlify, or AWS Amplify
- Backend (planned): AWS, Google Cloud Platform, or DigitalOcean
- Database: MongoDB Atlas, AWS RDS, or Google Cloud SQL
- CDN: Cloudflare for global content delivery
- Monitoring: Sentry for error tracking and performance monitoring
# Production Environment Variables
VITE_APP_ENV=production
VITE_API_BASE_URL=https://api.easylife-gangtok.com
VITE_GOOGLE_MAPS_API_KEY=your_production_maps_key
VITE_SENTRY_DSN=your_sentry_dsn
VITE_ANALYTICS_ID=your_analytics_id- Components: 25+ reusable React components
- Pages: 15+ route-level pages with full functionality
- Business Categories: 30+ service categories
- Sample Data: 50+ realistic business listings
- User Roles: 3 comprehensive user types with role-based access
- Admin Features: 10+ administrative management modules
- Responsive Design: Optimized for mobile, tablet, and desktop
We welcome contributions to improve Easy Life Gangtok! Here's how you can help:
- Fork the Repository
- Create Feature Branch:
git checkout -b feature/amazing-feature - Commit Changes:
git commit -m 'Add amazing feature' - Push to Branch:
git push origin feature/amazing-feature - Open Pull Request
- Follow the existing code style and TypeScript conventions
- Add meaningful comments for complex business logic
- Ensure responsive design for all new components
- Test thoroughly across different user roles
- Update documentation for new features
Developer: Kunal Kumar Pandit
Email: kunalkprnc@gmail.com
WhatsApp: +91 9471376362
LinkedIn: Kunal Kumar Pandit
Website: www.cyberkunal.com
GitHub: @kunaldevelopers
Project Repository: https://github.com/kunaldevelopers/Easy-Life
This project is licensed under the MIT License - see the LICENSE file for details.
- Inspiration: Local business communities of Gangtok, Sikkim
- Design System: Modern web design principles and accessibility standards
- Technology Stack: React ecosystem and modern web development tools
- Community: Open source contributors and the local business ecosystem
Built with ❤️ for the beautiful city of Gangtok, Sikkim
Transforming how locals discover and connect with businesses in the Himalayan region.