🚀 TripJet - Tourism Booking Platform

⚠️ Development Status

Note: This project is currently under active development. Features may change and improve over time.

Important: The main codebase is available in the dev branch. Please check out the dev branch to see the latest code and features.

🌟 Overview

TripJet is a cutting-edge tourism booking platform built with Next.js 15 and React 19. It provides a seamless experience for users to discover, explore, and book tours and travel experiences.

📸 Project Screenshots

✨ Features

• 🔐 User Authentication: Secure login and registration with Next-Auth
• 🔍 Tour Discovery: Browse and search for tours with advanced filtering
• 📅 Booking System: Easy and intuitive booking process
• 🗺️ Interactive Maps: Visualize tour routes and locations with Leaflet maps integration
• 👤 User Profiles: Manage personal information and booking history
• 📱 Responsive Design: Optimized for all devices using Tailwind CSS
• 🌐 Multilingual Support: Including Persian (Farsi) with Vazirmatn font integration

🛠️ Tech Stack

• 🔥 Frontend: Next.js 15, React 19
• 💅 Styling: Tailwind CSS 4, DaisyUI
• 🗺️ Maps: Leaflet for interactive map visualization
• 📊 State Management: React Query (TanStack Query)
• 📝 Forms: Formik with Yup validation
• 🎨 UI Components: Lucide React icons, React Modal, Swiper
• 🧰 Development Tools: ESLint, Prettier

📂 Project Structure

my-next-app/
├── node_modules/
├── public/
├── src/
│   ├── app/
│   │   ├── @auth/
│   │   ├── about-us/
│   │   ├── booking/
│   │   ├── contact-us/
│   │   ├── profile/
│   │   ├── tours/
│   │   ├── error.js
│   │   ├── globals.css
│   │   ├── layout.js
│   │   ├── loading.js
│   │   ├── not-found.js
│   │   ├── page.js
│   │   ├── components/
│   │   │   ├── AboutUs/
│   │   │   ├── auth/
│   │   │   ├── booking/
│   │   │   ├── common/
│   │   │   ├── contact/
│   │   │   ├── home/
│   │   │   ├── layout/
│   │   │   ├── profile/
│   │   │   ├── tours/
│   │   │   ├── ui/
│   │   ├── contexts/
│   │   │   ├── AuthContext.js
│   │   │   ├── TourFiltersContext.js
│   │   ├── hooks/
│   │   ├── lib/
│   │   ├── providers/
│   │   ├── services/
├── env/
├── env.local
├── .eslintignore
├── .eslintrc.js
├── .gitignore
├── .prettierignore
├── .prettierrc
├── eslint.config.mjs
├── jsconfig.json
├── next-env.d.ts
├── next.config.mjs
├── package-lock.json
├── package.json
├── postcss.config.mjs
├── README.md

🚦 Getting Started

Prerequisites

• 📦 Node.js 18.x or higher
• 📦 npm or yarn

Installation

1. Clone the repository: git clone https://github.com/PouyaBirvand/TripJet.git cd TripJet

2. Install dependencies: npm install

   or

   yarn install

3. Set up environment variables: Create a .env.local file based on .env example

4. Start the development server: npm run dev

   or

   yarn dev

5. Open http://localhost:3000 in your browser

📝 Available Scripts

• ⚡ npm run dev - Start development server with Turbopack
• 🏗️ npm run build - Build the application for production
• 🚀 npm run start - Start the production server
• 🔍 npm run lint - Run ESLint to check code quality
• ✨ npm run format - Format code with Prettier

🧪 Development Features

• ⚡ Turbopack: Faster development with Next.js Turbopack
• 🔄 React Query DevTools: Debug API requests and cache
• 🔗 URL State Management: Using nuqs for URL-based state
• 🧹 Code Quality: Enforced with ESLint and Prettier

🌐 Deployment

The application can be deployed on Vercel, Netlify, or any other platform that supports Next.js applications.

Example deployment on Vercel

vercel

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

Pouya Birvand - GitHub Profile

Project Link: https://github.com/PouyaBirvand/TripJet

---