React Vite TailwindCSS TypeScript Framer Motion License

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

1. Clone the Repository

   git clone https://github.com/kunaldevelopers/Easy-Life.git
   cd Easy-Life

2. Install Dependencies

   npm install

3. 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"

4. Start Development Server

   npm run dev

5. 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

1. Modern UI/UX: Contemporary design with smooth animations
2. Local Focus: Specifically designed for Gangtok's market needs
3. Real-time Updates: Instant business information updates
4. Advanced Filtering: Sophisticated search and discovery options
5. Mobile-First: Optimized for mobile users in the region
6. 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:

1. Fork the Repository
2. Create Feature Branch: git checkout -b feature/amazing-feature
3. Commit Changes: git commit -m 'Add amazing feature'
4. Push to Branch: git push origin feature/amazing-feature
5. 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.