{"id":26482836,"url":"https://github.com/cltxvz/tripplanner","last_synced_at":"2026-04-17T01:03:20.025Z","repository":{"id":270349996,"uuid":"910085817","full_name":"cltxvz/tripPlanner","owner":"cltxvz","description":"A planning app to organize, track, and budget your trips with ease!","archived":false,"fork":false,"pushed_at":"2025-03-17T17:06:20.000Z","size":6549,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T17:35:04.567Z","etag":null,"topics":["budget-tracking","css","drag-and-drop","github-pages","html","interactive-ui","itinerary-planner","javascript","local-storage","responsive-design","travel-management","user-friendly-interface","web-application"],"latest_commit_sha":null,"homepage":"https://cltxvz.github.io/tripPlanner/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cltxvz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-30T13:08:14.000Z","updated_at":"2025-02-12T19:36:18.000Z","dependencies_parsed_at":"2025-01-30T01:20:22.275Z","dependency_job_id":"931f950b-2318-46cc-8b0b-779fe81db305","html_url":"https://github.com/cltxvz/tripPlanner","commit_stats":null,"previous_names":["cltxvz/tripplanner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cltxvz/tripPlanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FtripPlanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FtripPlanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FtripPlanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FtripPlanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cltxvz","download_url":"https://codeload.github.com/cltxvz/tripPlanner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FtripPlanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31910584,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["budget-tracking","css","drag-and-drop","github-pages","html","interactive-ui","itinerary-planner","javascript","local-storage","responsive-design","travel-management","user-friendly-interface","web-application"],"created_at":"2025-03-20T04:49:53.970Z","updated_at":"2026-04-17T01:03:19.957Z","avatar_url":"https://github.com/cltxvz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 **TripPlanner**  \n\n*\"Plan, organize, and enjoy your perfect vacation!\"*  \n\n---\n\n## 🚀 **Description:**  \n\n**TripPlanner** is a powerful and user-friendly trip planning application built with **React**. Whether traveling solo or with a group, TripPlanner helps manage flights, accommodations, daily activities, budgets, and itineraries in a **seamless** and **interactive** way. With features like a **drag-and-drop itinerary builder**, **real-time budget tracking**, and **JSON-based import/export**, TripPlanner makes planning your dream vacation effortless.  \n\n---\n\n## 🛠️ **Technologies Used:**  \n\n### **Stack:**  \n- **Frontend:** React, Bootstrap, React Router.  \n- **State Management:** LocalStorage (for now, backend planned for the future).  \n- **Styling:** Bootstrap 5, CSS.  \n- **Version Control:** Git \u0026 GitHub.  \n\n---\n\n## 📚 **Skills \u0026 Concepts Applied**  \n\n- **React Component Architecture** → Modular, reusable components.  \n- **State Management** → LocalStorage for now, expandable to Backend DB.  \n- **React Hooks (useState, useEffect, useCallback)** for dynamic UI updates.  \n- **Event Handling** → Drag \u0026 Drop functionality for trip scheduling.  \n- **Data Persistence** → Saves trip data in browser storage for later retrieval.  \n- **Error Handling** → Improved UI feedback with alerts and validation.  \n\n---\n\n## 📖 **How to Use TripPlanner**  \n\n### **Set Up Your Trip**  \n1. Start by entering **destination, duration, and number of travelers**.  \n2. Edit trip details anytime via the **Edit Trip** section.  \n\n### **Manage Activities**  \n1. Add activities to your **Available Activities Pool** with details like cost and time.  \n2. Drag and drop activities into the **Daily Itinerary**.  \n3. Schedule activity times using the **calendar-style planner**.  \n\n### **Track Budgets \u0026 Costs**  \n1. View **real-time calculations** of trip expenses for individuals and groups.  \n2. Add flights, stays, and additional expenses in the **Trip Overview**.  \n\n### **Save, Export \u0026 Share Your Trip**  \n1. Trip data **automatically saves** in the browser via LocalStorage.  \n2. Export your trip plan as a **JSON file** for easy sharing or backup.  \n3. Import saved trip files to **resume planning instantly**.  \n\n---\n\n## 📊 **Features**  \n\n### 🔥 **Core Features**  \n✔ **Trip Overview** → Flights, stays, additional expenses, and budgets in one place.  \n✔ **Activity Management** → Add, edit, and remove activities dynamically.  \n✔ **Daily Itineraries** → **Calendar View** for structured trip scheduling.  \n✔ **Drag \u0026 Drop** → Schedule activities seamlessly with an interactive planner.  \n✔ **Budget Tracking** → **Automatic calculations for all travelers \u0026 per person**.  \n✔ **To-Do List** → Create and check off travel-related tasks.  \n✔ **Real-time Data Saving** → Ensures no progress is lost.  \n✔ **Import/Export** → Load and save trips as JSON files.  \n✔ **Mobile-Friendly** → Optimized UI for both **desktop \u0026 mobile**.  \n\n---\n\n## 🏗 **Future Enhancements**  \n\n### 🚀 **Backend Implementation (Planned)**  \n- **User Authentication** → Login system for personal trip storage.  \n- **Cloud Database (MongoDB, Firebase, PostgreSQL)** → Save trip data online.  \n- **Trip Collaboration Feature** → Share and edit trips with friends in real time.  \n- **Flight \u0026 Hotel API Integration** → Fetch real-time travel data.  \n- **AI-Powered Recommendations** → Suggest activities, budget optimizations, and schedules.  \n- **Expense Splitting** → Feature to split trip costs among travelers.  \n\n---\n\n## 🏃 **How to Run the Project Locally**  \n\n1. **Clone the repository:**  \n   ```bash\n   git clone https://github.com/cltxvz/tripPlanner.git\n   ```  \n2. **Navigate to the project folder:**  \n   ```bash\n   cd tripPlanner\n   ```  \n3. **Install dependencies:**  \n   ```bash\n   npm install\n   ```  \n4. **Start the development server:**  \n   ```bash\n   npm start\n   ```  \n5. Open `http://localhost:3000` in your browser to start planning your trip!  \n\n---\n\n## 👤 **Author**  \n\n**Carlos A. Cárdenas**  \n\nFeel free to reach out for collaboration or feedback!  \n\nThank you for using **TripPlanner**! 🌍✨ If you like this project, **⭐ star the repository** and contribute to its growth. 🚀  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Ftripplanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcltxvz%2Ftripplanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Ftripplanner/lists"}