Skip to content

Team-MaRo/wundexpertinplus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

101 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wund Expertin Plus

One-page website for Sibylle Bürgi-Lütscher — Dipl. Wundexpertin SAfW, Liestal.

License Contributor Covenant Docker Stars Docker Pulls Codacy grade

CI Pages Docker

Stack

  • React Router 7 (file-based routing, dual-mode SSR + SPA)
  • React 19 + TypeScript 5.9
  • Vite 8 + Tailwind v4 + Sass
  • i18next (German UI, all strings in app/locales/de.yml)
  • Google Maps JS API (client-side, via @googlemaps/js-api-loader)
  • pnpm 11 + Node 24
  • Nix flakes (devShell + reproducible OCI image, no Dockerfile)

Two deploys, one source

Mode Output Host
SSR=false pnpm build build/client/ (static SPA) GitHub Pages
pnpm build build/{client,server}/ (Node SSR) Nix OCI container (port 3000)

The fork is react-router.config.ts's ssr: process.env.SSR !== 'false'. CI builds both; deploy-gh-pages.yml sets SSR=false.

Getting started

pnpm install
cp .env.dist .env.local   # then fill in VITE_GOOGLE_MAPS_API_KEY
pnpm dev                  # http://localhost:5173

The Google Maps key is origin-restricted (whitelisted to the deployed domain), so it can ship in the client bundle — but we still source it from env to keep rotation out of source diffs. Without a key, the map area falls back to its stylised placeholder.

Three other dev paths:

  1. Devcontainer — VS Code → "Reopen in Container" (.devcontainer/devcontainer.json).
  2. Composedocker compose up dev (uses nixos/nix image to realise the dev shell + run Vite).
  3. Vagrant VMvagrant up boots a Debian VM with Docker + Traefik + mkcert for https://wundexpertinplus.test.

Building

pnpm build              # SSR build
SSR=false pnpm build    # SPA build
pnpm preview            # serve build/client locally (4173)

OCI image

nix build .#dockerImage
docker load < result
docker run --rm -p 3000:3000 d3strukt0r/wundexpertinplus:latest

On Windows / macOS without a host Nix install, run the nix build step inside nixos/nix:2.34.6.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

This project uses Conventional Commits.

Versioning

We use SemVer for versioning. For available versions, see the tags on this repository.

Authors

Special thanks for all the people who had helped this project so far

See also the full list of contributors who participated in this project.

I would like to join this list. How can I help the project?

We're currently looking for contributions for the following:

  • Bug fixes
  • Translations
  • etc...

For more information, please refer to our CONTRIBUTING.md guide.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Acknowledgments

This project currently uses no third-party libraries or copied code.