scani/frontend-app repository overview

⁠scani/frontend-app

React + Vite SPA served by nginx for Scani⁠ — the self-hostable, open-source portfolio tracker for crypto and traditional assets.

This is the only Scani container that needs to be reachable from the public internet. The bundled nginx reverse-proxies /api and /ws to scani/api⁠ over the compose network, so the SPA can be deployed against any backend host without rebuilding.

⁠Tags

• latest — highest semver release tag
• 1.2.3 / 1.2 / 1 — semver release tags

The image is built with VITE_API_URL=/api baked in — runtime backend selection happens via nginx config, not via rebuilding the SPA.

⁠Quick start

Use the reference docker-compose.prod.yml⁠ from the OSS repo:

git clone https://github.com/MGrin/scani-oss.git
cd scani-oss
cp .env.example .env                              # set BACKEND_URL etc.
docker compose -f docker-compose.prod.yml up -d

Put your own TLS-terminating reverse proxy (Caddy, Cloudflare Tunnel, an ingress, …) in front of this container.

⁠Required environment variables

Full annotated list: .env.example⁠.

⁠Source

Full source, architecture, and contribution guidelines: https://github.com/MGrin/scani-oss⁠

MIT licensed.