TRIP

🗺️ Tourism and Recreational Interest Points

📝 Table of Contents

• 📦 About
• 🌱 Getting Started
• 📸 Demo
• 🤝 Contributing
• 📜 License
• 🛠️ Tech Stack

📦 About

TRIP is a self-hostable minimalist Map tracker and Trip planner to visualize your points of interest (POI) and organize your next adventure details.

Core Features:

• Map and manage POIs on interactive maps
• Plan multi-day trips with detailed itineraries
• Collaborate and share with travel companions

No telemetry. No tracking. No ads. Free, forever.

See the 📸 demo to explore TRIP in action.

🌱 Getting Started

If you need help, feel free to open a discussion.

Deployment is designed to be simple using Docker.

Option 1: Docker Compose (Recommended)

Use the docker-compose.yml file provided in this repository. No changes are required, though you may customize it to suit your needs.

Run the container:

docker-compose up -d

Option 2: Docker Run

# Ensure you have the latest image
docker pull ghcr.io/itskovacs/trip:1

# Run the container
docker run -d -p 8080:8000 -v ./storage:/app/storage ghcr.io/itskovacs/trip:1

Configuration

Refer to the configuration documentation to set up OIDC authentication and other settings.

Tip

See Documentation to learn more.

📸 Demo

A demo is available at itskovacs-trip.netlify.app.

🤝 Contributing

Contributions are welcome! Open an issue to report bugs, start a discussion to share ideas or submit a pull request for new features.

1. Fork the repository
2. Create a new branch (my-new-trip-feature)
3. Commit and push your changes
4. Open a pull request

TRIP is and will always remain completely free, no paywalled features, no telemetry, no tracking, no ads. Development is supported through optional donations. If TRIP helps plan your adventures, consider leaving me a small tip ☕.

📜 License

TRIP is licensed under the CC-BY-NC-4.0. You may use, modify, and share freely with attribution, but commercial use is strictly prohibited.

In the spirit of free and open-source software, TRIP is now licensed under the MIT License to make it easier to use, modify, and share.

🛠️ Tech Stack

Frontend

• 🅰️ Angular 20
• 🏗️ PrimeNG 20
• 🎨 Tailwind CSS 4
• 🗺️ Leaflet 1.9 (plugins: Leaflet.markercluster, Leaflet.contextmenu)

Backend

• 🐍 FastAPI, SQLModel
• 🗃️ SQLite

If you like TRIP, consider giving it a ⭐ for visibility!
Made with ❤️ in BZH