Self-hosted application for managing cars (fleet or personal collection). Provides a REST API to create, read, update, and delete cars. Containerized for easy deployment.
- Node.js + TypeScript + Express backend
- Health check endpoint
- Cars CRUD endpoints (in-memory store to start)
- Dockerfile and docker-compose for self-hosting
- Copy environment file: cp .env.example .env
- Build and start the app: docker compose up -d --build
- API should be available at http://localhost:3000
- GET /health
- GET /api/cars
- POST /api/cars
- GET /api/cars/:id
- PUT /api/cars/:id
- DELETE /api/cars/:id
Request/response examples are documented inline in the code and will be expanded as the project evolves.
Requirements: Node.js 18+
- Install dependencies: npm install
- Start dev server (auto-reload): npm run dev
- Persist data using a database (e.g., Postgres)
- AuthN/AuthZ
- Basic UI
- Backups and observability
MIT