TRIP

🗺️ Tourism and Recreational Interest Points

📝 Table of Contents

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

📦 About

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

Demo is worth a thousand words, head to 📸 Demo.

🔒 Privacy-First – No telemetry, no tracking, fully self-hostable. You own your data. Inspect, modify, and contribute freely.

🌱 Getting Started

If you need help, feel free to open an issue.

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 Usage Tips in docs for advanced features.

📸 Demo

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

🚧 Roadmap

New features coming soon^TM, check out the development plan in the Roadmap Wiki.
If you have ideas 💡, feel free to open an issue.

If you want to develop new feature, feel free to open a pull request (see 🤝 Contributing).

📜 License

I decided to license trip under the CC BY-NC-SA 4.0. You may use, modify, and share freely with attribution, but commercial use is strictly prohibited.

🤝 Contributing

Contributions are welcome! Feel free to open issues if you find bugs and pull requests for your new features!

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

🛠️ Tech Stack

Frontend

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

Backend

• 🐍 FastAPI, SQLModel
• 🗃️ SQLite

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