# Coop Cloud Front

Frontend for Coop Cloud — a web UI wrapper around the `abra` CLI for
managing VPSs, containers and application deployments.

This repository contains a Vite + React + TypeScript app styled
with SCSS.

## Quick start

- Install dependencies (pnpm is recommended):

pnpm install
pnpm dev

```

The app uses Vite; start the dev server with `pnpm dev`.

## Environment

- The app reads runtime flags from Vite env variables. The default build uses mocked api data.
-To deploy on a real API without mocking, run:
pnpm start:prod

Modify `.env` file at the project root if you need to override values for
development (see Vite docs for env var conventions).

## Scripts

- `pnpm dev` — start dev server
- `pnpm build` — run TypeScript and build production assets
- `pnpm preview` — preview production build locally
- `pnpm lint` — run ESLint
- `pnpm lint:scss` — run Stylelint
- `pnpm format` — format with Prettier

## Notes about local development

- The repo contains mock JSON and a `mockApi` service to develop UI without
	a backend. Toggle mock mode with `VITE_MOCK_AUTH=true`.
- Routes are client-side using `react-router-dom`.

## Next steps / suggested work items

- Add form validation and better UX for `RecipeForm`.
- Improve accessibility.
- Add unit tests.
- Improve responsive layouts and card grid behaviour on narrow screens.
- Add deployment docs and production environment variables.

---