The project is designed for fast, modern, and efficient development using Vite and Yarn.

Tooling Overview

Bundler: Vite enables instant server startup, fast HMR, and optimized builds.
Package Manager: Yarn ensures consistent dependency management.
Type System: Strictly typed with TypeScript.
Testing: Jest and Testing Library power unit testing and DOM interaction testing.
Linting: ESLint for JavaScript/TypeScript, and Stylelint for CSS.
Formatting: Prettier for consistent code style.
CI-ready: Combined workflows for linting, formatting, type-checking, and tests are available via a single command.

Key Development Scripts

All scripts are defined in package.json for convenience and automation:

Script	Description
`yarn dev`	Start the Vite development server
`yarn build`	Build the project for production
`yarn preview`	Preview the production build locally
`yarn test`	Run unit tests with coverage
`yarn lint`	Run ESLint on TS/JS files
`yarn lint:fix`	Auto-fix lint issues
`yarn lint:css`	Run Stylelint on CSS files
`yarn lint:css:fix`	Auto-fix style issues
`yarn format`	Format code with Prettier
`yarn format:check`	Check formatting without writing
`yarn type-check`	Run TypeScript for type checking only
`yarn ci_workflow_test`	Full CI check simulation: lint, type-check, format, build, test
`yarn beenthere`	Spin up the full dev Docker stack (frontend + backend)
`yarn compose-down`	Stop frontend Docker container
`yarn backend`	Run the backend dev server via `make`

Codebase is split into feature-based folders (components, views, layers, data, etc.) for clarity and modularity.
Docker is supported for full-stack development using docker-compose-dev.yaml.
Backend development can be launched in parallel using yarn backend.