# DonUI (Donations Frontend) > CitizenGO's donation flow: a React 19 + Vite 7 + TypeScript SPA that renders > the donation form and integrates Stripe, PayPal, PayU, and GoCardless. This > file is the agent-readability entry point per the Vercel spec > (). Source of truth is > the `main` branch of ; links > below point at raw markdown files on that branch, with a few directory > listings and the aggregated `llms-full.txt` called out explicitly. For aggregated long-form standing context (charter + constitution + a pointer to the behavioral spec in one file), see [`/llms-full.txt`](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/public/llms-full.txt). ## Standing context Read these every agent run. Order matches precedence: direct user instruction wins, then the layer that owns the question (charter for agent behaviour, constitution for engineering principles), then `AGENTS.md`, then other docs. - [AGENTS.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/AGENTS.md) — operational runbook (commands, stack, validation). - [docs/agent-spec/01-charter.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/01-charter.md) — agent scope, guardrails, quality gates, speckit-flow obligation. - [.specify/memory/constitution.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/.specify/memory/constitution.md) — engineering principles and release quality. - [docs/agent-spec/README.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/README.md) — index of the agent-spec doc set (charter, runbooks, behavioral spec, this audit). - [docs/agent-spec/behavioral/overview.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/overview.md) — entry point to the tech-agnostic behavioral spec (traceability matrix + inherited constraints); see the Behavioral specification section below. ## Project map - [README.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/README.md) — human-facing project overview, setup, scripts, donation form internals, payment integration notes. - [docs/qa-prod.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/qa-prod.md) — AI-driven QA in CI/CD overview. - [docs/dual-host-hazteoir.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/dual-host-hazteoir.md) — historical context: the deployed app's HazteOir dual-host behavior (donate.hazteoir.org). Not canonical app behavior — under the monorepo, host/brand routing is expected to be inherited above the app rather than app-controlled. - [specs/](https://github.com/CitizenGO-Org/soft-donui/tree/main/specs) — per-feature specs (the working record of shipped and in-flight changes; canonical product behavior lives in docs/agent-spec/behavioral/). - [specs/009-donui-greenfield-rebuild/](https://github.com/CitizenGO-Org/soft-donui/tree/main/specs/009-donui-greenfield-rebuild) — quarantined, unverified audit material; do not use it for implementation or clean-room input. ## Behavioral specification Tech-agnostic specification of what DonUI does — detailed enough to rebuild on a different stack while preserving current look and behavior. Lives under `docs/agent-spec/behavioral/`. Supersedes the cancelled `src/` code catalogue. - [behavioral/overview.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/overview.md) — entry point, traceability matrix, constraints inherited from charter and constitution. - [behavioral/domain-model.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/domain-model.md) — entities, fields, relationships, lifecycle states. - [behavioral/user-flows.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/user-flows.md) — end-to-end journeys (OTD, MD, Express, subscription update). - [behavioral/capabilities/](https://github.com/CitizenGO-Org/soft-donui/tree/main/docs/agent-spec/behavioral/capabilities) — feature-level scenarios (amount, recurring, method, donor info, locale, currency, express, subscription, thank-you, error recovery, rate limits). - [behavioral/business-rules.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/business-rules.md) — validation, currency, locale fallback, recurring, fees, rate-limit semantics. - [behavioral/integrations.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/integrations.md) — payment provider contracts, donation submit contract, analytics events. - [behavioral/screens/](https://github.com/CitizenGO-Org/soft-donui/tree/main/docs/agent-spec/behavioral/screens) — per-screen UX (form shell, 3 form steps, 2 thank-you screens). - [behavioral/configuration-surface.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/behavioral/configuration-surface.md) — per-locale knobs and values per cluster. ## Per-change workflow Per-change deltas use spec-kit (`.specify/*` + `/speckit.*` skills) and emit artefacts under `specs//`. Charter's _Spec-Driven Workflow (speckit)_ section is the contract; specs cite behavioral-spec entries by path (e.g. `capabilities/amount-selection#preset-amount-selected`) and never copy their content. - [.specify/templates/](https://github.com/CitizenGO-Org/soft-donui/tree/main/.specify/templates) — plan, tasks, spec, checklist templates. ## Entry points (code) - `index.html` — Vite entry. - `src/main.tsx` — React bootstrap. - `src/App.tsx` — top-level route shell. - `src/payment/` — provider integrations (Stripe, PayPal, PayU, GoCardless, ExpressDonation, PaymentBase). - `src/stores/` — Zustand domain stores (donationForm, campaign, member, method, config, …). - `src/listCustomizations/` — per-locale donation form customisations. - `src/i18n.ts` + `public/locales/en-row/translation.json` — i18n source of truth. ## Audit trail - [docs/agent-spec/readability-audit.md](https://raw.githubusercontent.com/CitizenGO-Org/soft-donui/main/docs/agent-spec/readability-audit.md) — current Vercel agent-readability score, gap list, remediation plan.