Skip to content

Architecture Overview

Chewbills is split into a React frontend, a Node/Express backend, and this Astro Starlight documentation site. Key components:

  • Frontend (frontend/) — React 18 + React Router, Tailwind, React Query, Chart.js.
  • Backend (backend/) — Express APIs, Postgres, AI-provider routing, PDF/OCR pipelines.
  • Docs (docs/) — Astro + Starlight, fed by userguide.md to keep persona workflows synchronized.

Supporting scripts:

  • scripts/sync-readme-docs.js copies persona sections from userguide.md into these MDX files.
  • npm run docs:* helper commands build/run the docs locally and in CI.

See README.md for full architecture diagrams and deployment references.