{"id":29298794,"url":"https://github.com/bdamokos/travel-tracker","last_synced_at":"2025-10-04T13:42:06.191Z","repository":{"id":303223927,"uuid":"1014774988","full_name":"bdamokos/travel-tracker","owner":"bdamokos","description":"A web application for tracking travel data and expenses","archived":false,"fork":false,"pushed_at":"2025-10-04T00:40:59.000Z","size":3046,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T02:45:51.505Z","etag":null,"topics":["cost-tracker","maps","travel","travel-tracker","ynab"],"latest_commit_sha":null,"homepage":"https://travel-tracker.bdamokos.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bdamokos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-06T11:48:47.000Z","updated_at":"2025-10-04T00:41:02.000Z","dependencies_parsed_at":"2025-07-06T13:22:27.236Z","dependency_job_id":"bdae351f-be99-4add-a51a-20b2c324f2cd","html_url":"https://github.com/bdamokos/travel-tracker","commit_stats":null,"previous_names":["bdamokos/travel-tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bdamokos/travel-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdamokos%2Ftravel-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdamokos%2Ftravel-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdamokos%2Ftravel-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdamokos%2Ftravel-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bdamokos","download_url":"https://codeload.github.com/bdamokos/travel-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdamokos%2Ftravel-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278322187,"owners_count":25967872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cost-tracker","maps","travel","travel-tracker","ynab"],"created_at":"2025-07-06T18:38:59.546Z","updated_at":"2025-10-04T13:42:06.186Z","avatar_url":"https://github.com/bdamokos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Travel Tracker\n\n![Travel Tracker](./public/screenshots/embeddable_map.png)\n\nA web application that visualizes travel journeys on an OpenStreetMap (OSM) interface, allowing users to trace their routes through various transportation methods while displaying chronological travel notes, Instagram posts, and blog content alongside the map.\n\nFurthermore, it includes a private cost tracking feature that allows users to track their expenses and budgets.\n\n## Features\n\n- Interactive OpenStreetMap display with route visualization\n- Different route styles based on transportation type (air, land, sea)\n- Chronological travel timeline and calendar interface\n\n- Instagram post integration\n- Blog post integration\n- Comprehensive travel expense tracking and budget management\n- YNAB (You Need A Budget) integration for importing financial data\n- **Backup Management System** with restoration capabilities and automated cleanup\n- Responsive design for desktop and mobile\n- Server-side data storage\n\n![Travel Tracker Screenshot](./public/screenshots/admin_overview.png)\n![Travel Tracker Screenshot](./public/screenshots/cost_tracker.png)\n\n## Technologies Used\n\n- Next.js with TypeScript\n- Leaflet.js for map functionality\n- Server-side data storage with API endpoints\n- Tailwind CSS for styling\n- **Bun** as the package manager (fast, modern alternative to npm/yarn)\n\n## Getting Started\n\n### Prerequisites\n\n- Bun (https://bun.sh/) - install with `curl -fsSL https://bun.sh/install | bash`\n- Node.js 18.x or later (Bun includes its own Node.js runtime)\n\n### Installation (for local development)\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/bdamokos/travel-tracker.git\ncd travel-tracker\n```\n\n2. Install dependencies:\n```bash\nbun install\n```\n\n3. Run the development server:\n```bash\nbun run dev\n```\n\n4. Open [http://localhost:3000](http://localhost:3000) in your browser to see the application.\n\n## MCP server (for LLM tool access)\n\nWe ship a lightweight MCP server exposing public data to LLMs via tools:\n\n- `get_next_steps(tripId)` → `/api/travel-data/{tripId}/next-steps`\n- `get_trip(tripId)` → `/api/travel-data?id={tripId}`\n- `get_public_page_html(path)` → `/map/{id}` or `/embed/{id}`\n\nRun locally:\n\n```bash\nTRAVEL_TRACKER_BASE_URL=http://localhost:3000 bun run mcp:server\n```\n\nConfigure in Claude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"travel-tracker\": {\n      \"command\": \"/usr/local/bin/bun\",\n      \"args\": [\"run\", \"mcp:server\"],\n      \"env\": {\n        \"TRAVEL_TRACKER_BASE_URL\": \"https://your.public.domain\"\n      }\n    }\n  }\n}\n```\n\n### Installation (for production)\n\nSee the [deploy](./deploy) directory for example instructions on how to deploy the application.\n\n## Data Storage\n\nTravel Tracker stores all journey data on the server using API endpoints, ensuring your travel data is safely stored and accessible across devices.\n\n## Usage\n\n### Journey Management\n1. **Creating a Journey**: Click \"Create New Journey\" to start tracking your travels\n2. **Adding Days**: Click \"Add New Day\" to add a new day to your journey\n3. **Adding Locations**: In the edit form, go to the \"Locations\" tab to add places you've visited\n4. **Adding Transportation**: Track how you moved between locations\n5. **Adding Instagram Posts**: Link your Instagram posts to specific days in your journey\n6. **Adding Blog Posts**: Link your blog posts to specific locations in your journey\n\n\n### Cost Tracking\n11. **Creating a Cost Tracker**: Navigate to the \"Cost Tracking\" tab in the admin interface\n12. **Setting Budget**: Define your overall trip budget and optional country-specific budgets\n13. **Adding Expenses**: Record individual expenses with categories, amounts, and locations\n14. **YNAB Integration**: Upload YNAB export files to automatically import your financial data, or import them using an API key\n15. **Analytics**: View spending breakdowns by country, category, and time period\n\n## Issues\nThis application is written with my specific needs in mind - feel free to fork it and make it your own and contribute back.\n\nPotential expected issues:\n- YNAB export formats may differ based on individual YNAB account settings\n- Your currency and default currency may need to be manually changed in the code\n\n---\n\n**Note:** This project uses [Bun](https://bun.sh/) for dependency management and scripts. Bun is much faster than npm/yarn and fully compatible with Next.js projects. Npm should still work.\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdamokos%2Ftravel-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdamokos%2Ftravel-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdamokos%2Ftravel-tracker/lists"}