VTA Farm — Frontend

React 19 + Vite 8 + TypeScript 6 frontend for the VTA Farm identity platform.

Prerequisites

• Node.js 20+
• pnpm (npm install -g pnpm)

Local Development

1. Install dependencies

   pnpm install

2. Configure environment

   cp .env.example .env

3. Start the dev server

   pnpm dev

   The app runs at http://localhost:5173 with HMR enabled.

4. Available routes

   URL	Description
   /	Marketing homepage
   /login	User sign-in
   /portal	User portal (agents, create VTA, settings)
   /admin/login	Admin sign-in
   /admin	Admin panel (users, security)

Other Commands

pnpm lint        # ESLint
pnpm preview     # Preview the production build locally (serves dist/)

Releasing

Publishing a version to GHCR: docs/release.md.

Adding shadcn Components

pnpm dlx shadcn@latest add <component>

Components land in src/components/ui/.

License

VTA Farm is licensed under the Apache License 2.0. See NOTICE for attribution. Contributions are welcome under the terms in CONTRIBUTING.md.