TRIP
[](https://github.com/itskovacs/trip/issues)
[](/LICENSE)
πΊοΈ Tourism and Recreational Interest Points
## π Table of Contents
- π¦ [About](#about)
- π± [Getting Started](#getting_started)
- πΈ [Demo](#demo)
- π€ [Contributing](#contributing)
- π [License](#license)
- π οΈ [Tech Stack](#techstack)
## π¦ 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](#demo) to explore TRIP in action.
## π± Getting Started
If you need help, feel free to open a [discussion](https://github.com/itskovacs/trip/discussions).
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:
```bash
docker-compose up -d
```
### Option 2: Docker Run
```bash
# 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](https://github.com/itskovacs/trip/tree/main/docs/config.md) to set up OIDC authentication and other settings.
> [!TIP]
> See [Usage Tips](https://github.com/itskovacs/trip/tree/main/docs/usage_tips.md) in docs for advanced features.
## πΈ Demo
A demo is available at [itskovacs-trip.netlify.app](https://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 a small tip](https://ko-fi.com/itskovacs) β.
## π License
TRIP is licensed under the **CC BY-NC-SA 4.0**. You may use, modify, and share freely with attribution, but **commercial use is strictly prohibited**.
## π οΈ Tech Stack
### **Frontend**
- π
°οΈ Angular 20
- ποΈ PrimeNG 20
- π¨ 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
