Skip to content

README.md

Latest commit

 

History

History
53 lines (35 loc) · 1.51 KB

README.md

File metadata and controls

53 lines (35 loc) · 1.51 KB
Raw

Quick start (development)

  1. Clone the repository
  2. Create a .env file with environment variables or export them.
echo "PUBLIC_BACKEND_API_URL=http://127.0.0.1:8000/api" > .env

OR

export PUBLIC_BACKEND_API_URL=http://127.0.0.1:8000/api
  1. Install dependencies
npm install -g pnpm
pnpm install
  1. Start a development server (ensure that the django app is running)
pnpm run dev

Building

To create a production version of your app:

pnpm run build

You can preview the production build with pnpm run preview.

To deploy your app, you may need to install an adapter for your target environment.

Testing with Safari

Safari requires https. To test it, the simplest solution is to use a local instance of caddy. To have it work properly, it is necessary to trick vite by sending it the Origin variable, as vite does not handle environment variables. The Caddyfile provided here is working properly, and can be launched by simply typing "caddy run".

In this setup, it is necessary to launch the backend with an adjusted CISO_ASSISTANT_URL=https://localhost.

Testing SSO

  1. Use caddy run -c Caddyfile-sso
  2. Launch ORIGIN=https://localhost:8443 PUBLIC_BACKEND_API_EXPOSED_URL=https://localhost:8443/api pnpm run dev on frontend side
  3. Launch CISO_ASSISTANT_URL=https://localhost:8443 python manage.py runserver on backend side
  4. Use https://localhost:8443 as the connection URL.
  5. Configure your IdP accordingly.