Labs64.IO :: Customer Portal

Self-service portal for Labs64.IO end-users — a Vue 3 single-page app for managing accounts, subscriptions, and their interactions with the ecosystem's services. Authentication is handled at the edge via the Traefik auth-proxy (OIDC/JWT). A Java backend is planned but not yet implemented; see AGENTS.md for the current layout and developer guide.

Key Features

• Vue 3 (Composition API) SPA with Bootstrap 5 + Bootstrap Vue Next.
• Runtime configuration injected via a mounted env.json ConfigMap — the same image runs in every environment.
• Module federation support (@originjs/vite-plugin-federation) for composing micro-frontends.
• Multi-stage Docker build (Node for building, Nginx for serving).

🐳 Docker Support

This project includes a ready-to-use Dockerfile for a multi-stage production build using Node.js (for building) and Nginx (for serving the built files).

Build and Run the App with Docker

1. Build the frontend assets:

npm run build

2. Build the Docker image (if needed):

docker build -t customer-portal .

3. Start the container using Docker Compose, which mounts the local dist folder into the container:

docker compose up -d

Star History

Customize configuration

See Vite Configuration Reference.

Project Setup

npm install

Compile and Hot-Reload for Development

npm run dev

Type-Check, Compile and Minify for Production

npm run build

Run Unit Tests with Vitest

npm run test:unit

Run End-to-End Tests with Cypress

npm run test:e2e:dev

This runs the end-to-end tests against the Vite development server. It is much faster than the production build.

But it's still recommended to test the production build with test:e2e before deploying (e.g. in CI environments):

npm run build
npm run test:e2e

Lint with ESLint

npm run lint

License

The core of the Labs64.IO Ecosystem is entirely open source and free forever. Community modules are licensed under Apache License 2.0.