Files

Events.ClientApp

Events.ClientApp is the Vue 3 front-end for the Events-WebApi solution.

It uses:

  • Vite
  • Vue 3
  • PrimeVue
  • Auth0 Vue SDK

It is intended as a companion UI for:

  • Events.WebAPI for CRUD and lookup operations
  • Events.FilesAPI for certificate and Excel downloads

Scripts

Install dependencies:

npm install

Start the development server:

npm run dev

Build for production:

npm run build

Preview the production build:

npm run preview

By default, the Vite dev server runs on:

  • http://localhost:5173

Environment Configuration

The app reads configuration from Vite environment files.

Typical options are:

  • .env
  • .env.local

The project already includes:

  • .env.example

The simplest setup is to copy .env.example to .env.local and fill in the real values.

Example:

Copy-Item .env.example .env.local

Environment Variables

Required for Auth0 login

  • VITE_AUTH0_DOMAIN Auth0 tenant domain, for example fer-web2.eu.auth0.com

  • VITE_AUTH0_CLIENT_ID Auth0 client ID for the SPA application

Optional Auth0 settings

  • VITE_AUTH0_AUDIENCE API audience passed to Auth0 when requesting an access token

  • VITE_AUTH0_SCOPE Space-separated scopes requested during login

API configuration

  • VITE_API_BASE_URL Base URL of Events.WebAPI

  • VITE_FILES_API_BASE_URL Base URL of Events.FilesAPI

If VITE_API_BASE_URL is not set, the app falls back to:

  • https://localhost:7150

If VITE_FILES_API_BASE_URL is not set, the app falls back to:

  • https://localhost:7296

Example

VITE_AUTH0_DOMAIN=fer-web2.eu.auth0.com
VITE_AUTH0_CLIENT_ID=whed5Hdb8l1b1fGyyAz7Qrdsb2oKcSh3
VITE_AUTH0_AUDIENCE=https://erasmus-sta-2026/events-api
VITE_AUTH0_SCOPE=openid profile email events:read events:write
VITE_API_BASE_URL=https://localhost:7295
VITE_FILES_API_BASE_URL=https://localhost:7296

Notes

  • VITE_AUTH0_DOMAIN and VITE_AUTH0_CLIENT_ID are required if you want the Auth0 login flow to work.
  • VITE_AUTH0_AUDIENCE and VITE_AUTH0_SCOPE are optional in code, but are usually needed if the APIs expect bearer tokens with a specific audience and scopes.
  • VITE_API_BASE_URL should point to the running Events.WebAPI instance for local development.
  • VITE_FILES_API_BASE_URL should point to the running Events.FilesAPI instance for local development.
  • .env.local is for local development and should not be treated as a shared secrets file.

What The Client Demonstrates

  • login and token acquisition through Auth0
  • calling secured Events.WebAPI endpoints
  • downloading protected files from Events.FilesAPI
  • local development against separately running ASP.NET Core backends