
TRIP

[](https://github.com/itskovacs/trip/issues)
[](/LICENSE)
πΊοΈ Tourism and Recreational Interest Points

## π Table of Contents
- π¦ [About](#about)
- π± [Getting Started](#getting_started)
- πΈ [Demo](#Demo)
- π§ [Roadmap](#Roadmap)
- π [License](#License)
- π€ [Contributing](#Contributing)
- π οΈ [Tech Stack](#techstack)
## π¦ 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](#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](https://github.com/itskovacs/trip/issues).
> [!CAUTION]
> :boom: change on Docker volume. If you come from `<1.5.0`, follow the [few steps](https://github.com/itskovacs/trip/releases/tag/1.5.0) to migrate your data.
```bash
# Ensure you have the latest image
docker pull ghcr.io/itskovacs/trip:1
# Run the container
docker run -p 8080:8000 -v ./storage:/app/storage ghcr.io/itskovacs/trip:1
```
If you want to configure OIDC authentication or other settings, see [config docs](https://github.com/itskovacs/trip/tree/main/docs/config.md).
## πΈ Demo
A demo is available at [itskovacs-trip.netlify.app](https://itskovacs-trip.netlify.app/).
| | |
|:-------:|:-------:|
|  |  |
|  |  |
## π§ Roadmap
New features coming soonTM, check out the development plan in the [Roadmap Wiki](https://github.com/itskovacs/trip/wiki/Roadmap).
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](#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](https://github.com/Leaflet/Leaflet.markercluster), [Leaflet.contextmenu](https://github.com/aratcliffe/Leaflet.contextmenu))
### **Backend**
- π FastAPI, SQLModel
- ποΈ SQLite
If you like TRIP, consider giving it a **star** β!
Made with β€οΈ in BZH