Super Comparison App

A scalable, production-ready price comparison platform built with Next.js and Express. Compare prices across multiple platforms for cabs, food delivery, hotels, and travel tickets.

🚀 Features

• Cab Price Comparison: Compare prices from Ola, Uber, and Rapido
• Food Delivery Comparison: Compare prices from Zomato and Swiggy
• Hotel Price Comparison: Compare prices across multiple booking platforms
• Travel Ticket Comparison: Compare bus and flight prices from various providers

🛠️ Tech Stack

Frontend

• Framework: Next.js 14 (App Router)
• Styling: Tailwind CSS
• Language: TypeScript
• HTTP Client: Axios

Backend

• Framework: Express.js
• Language: Node.js
• Architecture: RESTful API

📁 Project Structure

Super/
├── backend/                    # Express backend (Node.js)
│   ├── package.json            # Backend-only scripts and deps
│   ├── controllers/
│   ├── routes/
│   ├── services/
│   └── server.js
│
├── frontend/                   # Next.js 14 (App Router) frontend
│   ├── package.json            # Frontend-only scripts and deps
│   ├── next.config.js
│   ├── tailwind.config.js
│   ├── postcss.config.js
│   ├── tsconfig.json
│   └── src/
│       ├── app/
│       │   ├── compare/
│       │   │   ├── cab/
│       │   │   ├── food/
│       │   │   ├── hotel/
│       │   │   └── travel/
│       │   ├── layout.tsx
│       │   ├── page.tsx
│       │   └── globals.css
│       ├── components/
│       │   ├── home/
│       │   └── layout/
│       └── lib/
│           ├── api/
│           └── utils/
│
├── package.json                # Root npm workspaces
├── README.md
└── QUICKSTART.md

🚦 Getting Started

Prerequisites

• Node.js 18+ installed
• npm or yarn package manager

Installation

1. Clone the repository (or navigate to the project directory):

   cd "c:\Users\risha\Desktop\Super"

2. Install workspace dependencies:

   npm install

3. Set up environment variables:

   Copy-Item .env.example .env

   Edit .env and configure your settings.

Running the Application

Development Mode (two terminals)

1. Backend API

   npm run dev:backend

   Runs on http://localhost:5000

2. Frontend Web

   npm run dev:frontend

   Runs on http://localhost:3000

Production Mode

1. Build frontend

   npm run build

2. Start backend

   npm run server

3. Start frontend (production)

   npm run start

📡 API Endpoints

Cab Comparison

• POST /api/cab/compare - Compare cab prices
• GET /api/cab/providers - Get available cab providers

Food Delivery Comparison

• POST /api/food/compare - Compare food delivery prices
• GET /api/food/providers - Get available food delivery providers

Hotel Comparison

• POST /api/hotel/compare - Compare hotel prices
• GET /api/hotel/providers - Get available hotel booking providers

Travel Comparison

• POST /api/travel/compare/bus - Compare bus ticket prices
• POST /api/travel/compare/flight - Compare flight ticket prices
• GET /api/travel/providers - Get available travel booking providers

🔌 Integrating Real APIs

Currently, the application uses mock data. To integrate real APIs:

1. Add API keys to .env:

   OLA_API_KEY=your_key_here
   UBER_API_KEY=your_key_here
   # ... etc

2. Update controllers in backend/controllers/:

   • Replace mock data with actual API calls
   • Use the comparisonService to analyze real data
   • Handle API errors appropriately

3. Example integration:

   // In cabController.js
   const olaData = await fetch(`${OLA_API_URL}/estimate`, {
     headers: { Authorization: `Bearer ${process.env.OLA_API_KEY}` },
   });

🎨 Customization

Styling

• Modify tailwind.config.js for theme customization
• Update colors in the theme.extend.colors section
• Edit src/app/globals.css for global styles

Adding New Comparison Services

1. Create new controller in backend/controllers/
2. Create new route in backend/routes/
3. Add route to backend/server.js
4. Create API service in src/lib/api/
5. Create UI page in src/app/compare/
6. Add card to src/components/home/ComparisonCards.tsx

🔒 Security Considerations

• API keys should never be exposed to the frontend
• All API calls should be proxied through the backend
• Implement rate limiting on API endpoints
• Add authentication for user-specific features
• Sanitize all user inputs
• Use HTTPS in production

🚀 Deployment

Frontend (Vercel)

1. Push code to GitHub
2. Connect repository to Vercel
3. Configure environment variables
4. Deploy

Backend (Render/Railway/Heroku)

1. Choose a hosting provider
2. Configure environment variables
3. Set start command: node backend/server.js
4. Deploy

📝 Future Enhancements

• User authentication and saved searches
• Price history tracking
• Email/SMS price alerts
• Affiliate program integration
• Mobile app (React Native)
• Advanced filters and sorting
• Cashback and rewards integration
• Multi-language support

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

Built with ❤️ by Super Comparison Team

📞 Support

For support, email support@supercomparison.com or open an issue on GitHub.

---

Note: This project currently uses mock data for demonstration purposes. Integrate real APIs from service providers to enable actual price comparison functionality.