Zaken frontend

Production

wonen.zaken.amsterdam.nl

Acceptance

acc.wonen.zaken.amsterdam.nl

Development

• There is a dependency on https://github.com/Amsterdam/zaken-backend

• git clone https://github.com/Amsterdam/zaken-frontend.git

• cd zaken-frontend

• npm install

• npm run swagger:generate-schema

• npm run start

Bypassing authentication

• When running zaken-frontend and zaken-backend locally, it's possible to bypass Keycloak authentication. See https://github.com/Amsterdam/zaken-frontend/tree/main/src/app/state/auth/keycloak.

Required access to services for development

• ADW account (@amsterdam.nl)
• GitHub repository (https://github.com/Amsterdam/zaken-frontend) OIS Basis
• GitHub repository dependency (https://github.com/Amsterdam/wonen-ui) OIS Basis
• GitHub repository dependency (https://github.com/Amsterdam/amsterdam-react-final-form) OIS Basis
• NPM (https://www.npmjs.com/settings/amsterdam/packages) OIS Slack #frontend-amsterdam

Connecting to Acceptance API

• It's possible to connect a locally run zaken-frontend to Acceptance API. Add VITE_API_URL=https://acc.api.wonen.zaken.amsterdam.nl/api/v1/ to .env.development.local. See .env.development for examples.

Deployment

The main branch is automatically deployed to acceptance.

Tag any branch, but preferably main, with a tag like v1.0.0 to deploy that specific commit to production.

A npm run deploy:prod convenience script is also available. This also guarantees the versions between the Git tag and NPM (package.json) are in sync.

Directory tree structure

tree -I "node_modules|.next|.git" -L 10 > directory-tree.txt