A full-stack travel platform to discover destinations, browse hotels & activities, plan trips, and book — with a secure auth flow and an admin management panel.

Saffarni is a full-stack web application built with a modern React frontend and a RESTful Node/Express + MongoDB backend. Users can explore travel destinations, view hotels and activities on an interactive map, plan trips, and make bookings, while administrators manage the platform's content through a dedicated admin area.

🔗 Live demo: saffarni.vercel.app

• 🔍 Discover destinations — browse curated travel destinations with details and imagery
• 🏨 Hotels & activities — explore accommodations and things to do at each destination
• 🗺️ Interactive maps — location views powered by Leaflet & OpenStreetMap
• 🧳 Trip planning — assemble trips from destinations, hotels, and activities
• 📅 Bookings — create and manage your bookings
• 🔐 Authentication — secure JWT-based sign up / login with protected routes

• 🛠️ Admin panel — manage destinations, hotels, activities, and trips
• 👥 User management — oversee user accounts
• 📊 Centralized CRUD — full create / read / update / delete over platform content

Saffarni/
├── backend/                  # Node + Express REST API
│   ├── Configuration/        # DB & environment setup
│   ├── Controllers/          # Route handler logic
│   ├── Middleware/           # Auth, error handling, etc.
│   ├── Models/               # Mongoose schemas
│   ├── Routes/               # API route definitions
│   ├── index.js              # Server entry point
│   ├── seedDestinations.js   # DB seeding script
│   └── vercel.json           # Serverless deployment config
│
└── saffarni-app/             # React + Vite frontend
    ├── src/
    │   ├── Routes/           # App route definitions
    │   ├── components/       # Reusable UI components
    │   ├── context/          # React context (state/auth)
    │   ├── services/         # API / business logic
    │   ├── data/             # Static / seed data
    │   ├── lib/              # Helpers (cn, utils)
    │   ├── utils/            # Utility functions
    │   ├── App.jsx           # Root component
    │   └── main.jsx          # App entry point
    ├── tailwind.config.js
    └── vite.config.js

• Node.js 18+
• MongoDB (local instance or MongoDB Atlas free cluster)
• npm

git clone https://github.com/Gaston202/Saffarni.git
cd Saffarni

cd backend
npm install
cp .env.example .env      # then fill in your environment variables
npm run seed              # optional: seed destinations into the DB
npm run dev               # starts the API with nodemon (http://localhost:PORT)

cd ../saffarni-app
npm install
cp .env.example .env      # then point VITE_API_URL at your backend
npm run dev               # starts Vite dev server (http://localhost:5173)

Configure each app from its .env.example file.

backend/.env — typical variables (confirm against .env.example):

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
JWT_EXPIRES_IN=7d
CLIENT_URL=http://localhost:5173

saffarni-app/.env — typical variables (confirm against .env.example):

VITE_API_URL=http://localhost:5000

⚠️ Never commit real .env files. Only .env.example templates should be in version control.

The backend exposes REST resources (mounted under the routes folder):

Authentication is JWT-based: protected endpoints expect an Authorization: Bearer <token> header.

• User reviews & ratings for hotels/activities
• Payments integration
• Search & filtering (price, location, category)
• Multi-language support
• Mobile-responsive polish & PWA

Contributions are welcome! This is a personal/learning project, but feel free to fork and experiment.

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

This project is open-source and available under the MIT License.

Gaston — GitHub @Gaston202

Built as a full-stack learning project to practice React, Node/Express, MongoDB, and deploying real apps to Vercel.