C·V·Q·O

codex visioque

A small Express server written in Typescript running in a Docker-Container, serving a server-side rendered React Application. This Repository is meant to be used for experimentation and trying out stuff, without relying on create-react-app or Next.js.

Installing

pnpm install

Developing

build locally:

pnpm run build

run all apps in development mode:

pnpm run dev

serve production build:

pnpm run serve

Docker

Since the application is split into multiple microfrontends, you will need to run these apps in their respective containers.

build a Docker-Container:

docker build --tag node-[APP] -f ./apps/[APP]/Dockerfile .

run as Docker-Container:

docker run -d -p 3000:3000 node-[APP]

Messed Around With

• Minimal React Single Page Application
• NodeJS Express Server providing SSR
• Module Federation on Server and Client
• Static Site Generation
• SCSS Modules Styles
• Typescript
• Rspack Bundling
• Monorepositories
• Serviceworker using Workbox (for offline-Mode)
• Linting
• Prettier
• Vitest + React Testing Library
• and of course: dark mode

CI/CD

This project uses GitHub Actions for continuous integration. The following checks run automatically:

• Linting: Ensures code style consistency
• Tests: Runs the Vitest test suite
• Integration: Builds all apps, starts them, and runs smoke tests (health checks, API endpoints, SSR, security headers)
• E2E: Runs Playwright end-to-end tests
• Lighthouse: Runs Lighthouse CI performance audits

The CI pipeline runs on:

• Push to main and develop branches
• Pull requests to main and develop branches

forever ignored

• Internet Explorer Support