Single Page Application Demo using Engity IdP

This Single Page Application demonstrates the integration with the IdP (Identity Provider) of the Engity GmbH.

It is available at https://demo.engity.app.

TOC

1. Structure
2. Development
3. FAQ
4. License

Structure

• OpenID Connect: oidc-client-ts with react-oidc-context (src/lib/authentication.tsx)

  ℹ️ This project supports multiple sub-paths which are dynamically resolved (configured in src/environments/environment.ts). As a result, the authentication procedure is a little bit more complex as a regular application. Please keep this in mind.

• Basic Framework: React (entry point: src/index.tsx)

• Language: TypeScript (tsconfig.json)

• Build system: RSBuild (rsbuild.config.cts)

• Linting/Formatting: Biome (biome.jsonc)

• I18n: i18next with react-i18next (src/lib/i18n.ts)

• Router: React Router

• Theme: Radix UI with Lucide React

• Charts: React ApexCharts

Development

Requirements

1. Have at least Nodejs 23.10+ installed (node -v)
2. Have at least NPM 23.10+ installed (npm -v and npx -v)
3. Have at least mkcert v1.4.4 installed (mkcert --version)
4. Have all dependencies installed

   npm install

5. Have a local CA for your mkcert installed (if not already done)

   npm run ensure-ca

6. Ensure have a certificate and key for local development of this SPA installed

   npm run issue-cert

Run

Run the local development server.

npm run serve

Now it will be available at:

1. https://local.engity.dev:4200
2. https://local.engity.dev:4200/magic-link
3. https://local.engity.dev:4200/username

ℹ️ If you cannot resolve the host, see FAQ: local.engity.dev cannot be resolved;

FAQ

local.engity.dev cannot be resolved

Some routers enabled a feature called DNS rebinding protection. These will prevent external domains (like local.engity.dev) to be resolved to 127.0.0.1. In this case you need either to tell your router to accept an exception for this domain or simply add an entry to your local /etc/hosts:

1. Open the hosts file on your operating system:
   • Linux/macOS

     sudo vi /etc/hosts

   • Windows

     sudo notepad c:\Windows\System32\drivers\etc\hosts

2. Ensure you have the following content:

   127.0.0.1  local.engity.dev
   ::1        local.engity.dev