✈️ TripTailor

A workspace-based travel itinerary planning platform

Plan smarter. Travel better. Think Notion — but for your adventures.

---

🧭 What is TripTailor?

TripTailor is a modern, productivity-style travel planning workspace built with Laravel MVC and Blade templating. It replaces the chaos of planning trips across WhatsApp chats, spreadsheets, screenshots, and notes apps — bringing everything into one clean, structured platform.

Inspired by the design philosophy of Notion, Linear, Todoist, and Arc Browser, TripTailor feels less like a travel app and more like a focused creative workspace dedicated entirely to your adventures.

---

🚀 Features

Feature	Description
Trip Management	Create and manage trips with title, destination, dates, budget, and notes
Day-wise Itineraries	Organize activities chronologically by day with times, locations, and categories
Favorites	Bookmark trips and access them instantly from the sidebar
Explore Templates	Pre-built itineraries like Goa Weekend, Kerala Escape, Manali Adventure
Budget Tracking	Estimate and track trip expenses from the dashboard
Search & Filters	Quickly find and filter trips by labels and categories
Weather Integration	Preview weather conditions for your travel destination
PDF Export	Export your itinerary as a printable PDF (coming soon)
Dark Productivity UI	A premium dark-themed interface with orange accents

---

🖥️ Tech Stack

Backend    →  Laravel 10+ (PHP 8.x) — MVC, Eloquent ORM, Routing
Frontend   →  Blade Templating + Tailwind CSS v4 + Alpine.js
Database   →  MySQL 8.x
Auth       →  Laravel Breeze (Blade + Alpine stack, dark mode)
Testing    →  Pest
Version Control  →  GitHub

Typography: Bricolage Grotesque (headings) · Albert Sans (body)

---

📁 Project Structure

triptailor/
├── app/
│   ├── Http/Controllers/
│   │   ├── DashboardController.php
│   │   ├── TripController.php
│   │   ├── ActivityController.php
│   │   └── ExploreController.php
│   └── Models/
│       ├── User.php
│       ├── Trip.php
│       └── Activity.php
│
├── resources/views/
│   ├── layouts/
│   │   ├── app.blade.php
│   │   └── dashboard.blade.php
│   ├── components/dashboard/
│   │   ├── sidebar.blade.php
│   │   ├── header.blade.php
│   │   ├── trip-card.blade.php
│   │   └── dropdown.blade.php
│   ├── dashboard/
│   │   ├── home.blade.php
│   │   ├── explore.blade.php
│   │   ├── create-trip.blade.php
│   │   └── get-started.blade.php
│   └── trips/
│       ├── create.blade.php
│       ├── show.blade.php
│       └── edit.blade.php
│
├── database/migrations/
├── routes/web.php
└── public/

---

⚙️ Local Setup

Prerequisites

Make sure you have the following installed:

• PHP 8.x
• Composer
• Node.js & npm
• MySQL 8.x
• Git

Installation

1. Clone the repository

git clone https://github.com/[your-org]/triptailor.git
cd triptailor

2. Install PHP dependencies

composer install

3. Install Node dependencies

npm install

4. Configure environment

cp .env.example .env
php artisan key:generate

Edit .env with your local database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=triptailor
DB_USERNAME=root
DB_PASSWORD=your_password

5. Run database migrations

php artisan migrate

6. (Optional) Seed the database with sample templates

php artisan db:seed

7. Start the development servers

# In one terminal — compile assets
npm run dev

# In another terminal — serve the app
php artisan serve

Visit http://localhost:8000 in your browser.

---

🗄️ Database Schema

users
  └── id, name, email, password, timestamps

trips
  └── id, user_id, title, location, start_date, end_date,
      budget, description, notes, is_favorite, timestamps

activities
  └── id, trip_id, day_number, title, description, location,
      start_time, end_time, category, notes, timestamps

Relationships:

• User → hasMany → Trip
• Trip → belongsTo → User
• Trip → hasMany → Activity
• Activity → belongsTo → Trip

---

🧪 Running Tests

php artisan test
# or
./vendor/bin/pest

---

👥 Team

Name	Registration No.
Sagar Sahu	12326460
Harshit Singh	12316515
Soumyosish Pal	12317736

Developed as part of CA-2 — Web Application Development, Spring 2025.

---

🗺️ Roadmap

• Landing page & dark UI system
• Laravel Breeze authentication
• Dashboard workspace shell
• Sidebar with interactions (dropdowns, hover menus, accordions)
• Trip CRUD & trip detail workspace
• Day-wise activity management
• Explore templates page
• Dynamic partial rendering (HTMX / Alpine AJAX)
• Weather API integration
• PDF itinerary export
• AI itinerary generation (future)
• Collaborative trip planning (future)

---

📜 License

This project is licensed under the MIT License.

---

Made with ☕ and too many itineraries · TripTailor © 2025