An all-in-one next-generation platform for eCommerce, travel, and utility services. BoominSquare seamlessly integrates a comprehensive store marketplace, flight and hotel reservations, and everyday utility payments into a single, intuitive web experience.

• 🛫 Travel & Tourism
  • Flights: Search and book flights globally with live pricing, dynamic loading animations, and robust local fallback mechanisms for airport autocompletion.
  • Hotels: Browse and reserve accommodations easily.
  • Tours & Transfers: Explore local activities and book reliable airport or city transfers.
• 🛍️ eCommerce Marketplace
  • Store: Full-featured online store for buyers across various categories.
  • Track Order: Real-time order tracking functionalities.
  • Sellers Hub: Dedicated "Sell on BoominSquare" landing page for seamless vendor onboarding.
• ⚡ Utilities & Services
  • Bills & Airtime: Pay bills and purchase airtime securely (Powered by the Reloadly API).
• 🔒 Security & Auth
  • Secure account registration with an OTP-based flow and comprehensive error handling.

• Framework: Next.js (App Router)
• Library: React 19
• Database ORM: Prisma
• Styling: Tailwind CSS
• Animations: Framer Motion
• UI Components: Radix UI, Lucide React
• Data Fetching: Axios

boominsquare/
├── src/
│   ├── app/           # Next.js App Router pages (flights, hotels, store, sellers, etc.)
│   ├── components/    # Reusable React components (FlightLoader, UI elements)
│   ├── config/        # Application configurations
│   ├── data/          # Static data and constants
│   ├── lib/           # Utility functions and library setups
│   ├── services/      # External API wrappers (e.g., Reloadly, FlightAPI)
│   └── types/         # TypeScript type definitions
├── prisma/            # Database schema and migrations
├── public/            # Static assets (images, icons)

• Node.js (v18 or higher)
• npm, yarn, or pnpm
• A relational database accessible for Prisma

1. Clone the repository:

   git clone https://github.com/yourusername/boominsquare.git
   cd boominsquare

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env or .env.local file in the root directory and add your keys based on the existing configurations. Example:

   DATABASE_URL="your_database_connection_string"
   # Add other required API keys (Reloadly, etc.)

4. Initialize the Database: Generate the Prisma client:

   npx prisma generate

   Apply migrations:

   npx prisma migrate dev

5. Run the development server:

   npm run dev

   Open http://localhost:3000 in your browser to see the app.

• npm run dev - Starts the Next.js development server.
• npm run build - Generates Prisma client and builds the application for production.
• npm run start - Starts the Next.js production server.
• npm run lint - Runs ESLint to analyze the code.
• npm run dev:test-network - Utility script to test the connection to the Reloadly network.
• npm run migrate:deploy - Deploys Prisma migrations.

This project is proprietary and intended for authorized use only.