yavadmin/ledgr-web repository overview

Ledgrr — Vite + React (JSX) PWA frontend for the Ledgrr personal-finance app.

⁠Ledgrr Web

ledgr-web is the frontend for Ledgrr⁠ — an AI-native, self-hostable personal-finance manager.

It's a Vite + React 18 (JavaScript / JSX, no TypeScript) single-page PWA built with shadcn/ui + Tailwind CSS: the dashboards, accounts & net worth, transactions, budgets, recurring, goals, the AI suggestions modal, the import wizard, and the admin panel.

⁠Tags

⁠What's inside

• Vite + React 18 (JSX only)
• shadcn/ui + Radix + Tailwind CSS
• Dexie (IndexedDB) + outbox, vite-plugin-pwa (offline-first)
• Production build served as static assets behind the ledgr-nginx ingress

Platform: linux/amd64.

⁠Quick start

This image serves the built SPA and is designed to run behind ledgr-nginx as part of the Ledgrr stack. Use the project's docker-compose.prod.yml:

git clone https://github.com/YavLabs/ledgrr.git
cd ledgrr
cp .env.example .env
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Browsers always reach the app through the single Nginx port (APP_PORT, default 8080) — never this container directly.

⁠Environment

The SPA talks to the API same-origin via /api/v1 (proxied by Nginx), so it needs no per-deploy secrets. Branding, feature flags, and localization are served at runtime from the API's public /branding endpoint. APP_BASE_URL (set on the stack) is the single public origin everything derives from.

See .env.example⁠.

⁠Links

• Source: https://github.com/YavLabs/ledgrr⁠
• API image: https://hub.docker.com/r/yavadmin/ledgr-api⁠
• Nginx image: https://hub.docker.com/r/yavadmin/ledgr-nginx⁠
• All-in-one image: https://hub.docker.com/r/yavadmin/ledgrr-app⁠ — this UI, the API and nginx in one container
• Deployment guide: https://github.com/YavLabs/ledgrr/blob/main/DEPLOY.md⁠