NOMAD

Navigation Organizer for Maps, Activities & Destinations

A self-hosted travel planner for organizing trips, places, budgets, packing lists, and more.

Features

• Drag & Drop Planner — Organize places into day plans with drag & drop reordering
• Interactive Map — Leaflet map with place markers, route visualization, and customizable tile sources
• Google Places Search — Search and auto-fill place details including ratings, reviews, and opening hours (requires API key)
• Weather Forecasts — Current weather and 5-day forecasts for your destinations (requires API key)
• Budget Tracking — Category-based expenses with pie chart, per-person/per-day splitting, and multi-currency support
• Packing Lists — Grouped checklists with progress tracking, drag & drop reordering, and smart suggestions
• Reservations — Track booking status, confirmation numbers, and reservation details
• File Storage — Attach documents, tickets, and PDFs to your trips (up to 50 MB per file)
• Photo Gallery — Upload and manage trip photos with lightbox view
• PDF Export — Export complete trip plans as PDF
• Multi-User — Invite members to collaborate on shared trips
• Day Notes — Add notes to individual days
• Admin Panel — User management, global categories, API key configuration, and backups
• Auto-Backups — Scheduled backups with configurable interval and retention
• Dark Mode — Full light and dark theme support
• Multilingual — English and German (i18n)
• Customizable — Temperature units, time format (12h/24h), map tile sources, default coordinates

Tech Stack

• Backend: Node.js 22 + Express + SQLite (node:sqlite)
• Frontend: React 18 + Vite + Tailwind CSS
• State: Zustand
• Auth: JWT
• Maps: Leaflet + Google Places API (optional)
• Weather: OpenWeatherMap API (optional)
• Icons: lucide-react

Deployment with Docker

Prerequisites

• Docker & Docker Compose

1. Clone the repository

git clone https://github.com/mauriceboe/NOMAD.git
cd NOMAD

2. Configure environment

Variable	Required	Description
JWT_SECRET	Yes (production)	Secret key for JWT signing (min. 32 characters). Auto-generated in development.
ALLOWED_ORIGINS	No	Comma-separated list of allowed origins (default: http://localhost:3000)
PORT	No	Server port (default: 3000)

Set these in docker-compose.yml under environment.

3. Start the app

docker compose up -d --build

The app is now running on port 3000.

4. First setup

The first user to register automatically becomes the admin. No default credentials.

Updating

git pull
docker compose up -d --build

Your data is persisted in the ./data and ./uploads volumes.

Reverse Proxy (recommended)

For production, put NOMAD behind a reverse proxy with HTTPS (e.g. Nginx, Caddy, Traefik).

Example with Caddy:

nomad.yourdomain.com {
    reverse_proxy localhost:3000
}

Update ALLOWED_ORIGINS in docker-compose.yml to match your domain:

environment:
  - ALLOWED_ORIGINS=https://nomad.yourdomain.com

Optional API Keys

API keys are configured in the Admin Panel after login.

Google Maps (Place Search)

1. Go to Google Cloud Console
2. Create a project and enable the Places API (New)
3. Create an API key under Credentials
4. In NOMAD: Admin Panel → API Keys → Google Maps

OpenWeatherMap (Weather Forecasts)

1. Sign up at OpenWeatherMap
2. Get a free API key
3. In NOMAD: Admin Panel → API Keys → OpenWeatherMap

Data & Backups

• Database: SQLite, stored in ./data/travel.db
• Uploads: Stored in ./uploads/
• Backups: Create and restore via Admin Panel
• Auto-Backups: Configurable schedule and retention in Admin Panel

License

MIT