Grouper is an Angular app for creating sessions and grouping people based on preferences.
A live demo of the application is available at https://grouper.kim-ipsen.workers.dev/.
Importable sample classes for testing and demos are described in docs/sample-data.md.
grouper-app/: main application (Angular 22, standalone components)docs/: project documentation and release notes
- Install dependencies:
npm install npm --prefix grouper-app install
- Start the app:
npm --prefix grouper-app start
- Open
http://localhost:4204.
Run from the repository root unless stated otherwise.
- Start app:
npm --prefix grouper-app start - Build app:
npm --prefix grouper-app run build - Lint app:
npm run lint - Run unit tests:
npm --prefix grouper-app test -- --watch=false - Run accessibility specs:
npm --prefix grouper-app run test:a11y
- Session export includes only the latest 5
groupingHistoryentries. - Preference scoring is configurable per session:
preferenceScoring.wantWith(default2)preferenceScoring.avoid(default-2)
- Custom weights are configurable per weight:
- each custom weight has a
mode:balanceormatch-similar - mode is set when the weight is created and can be changed later
- weighted grouping uses the mode of each selected custom weight
- legacy imported weights without
modedefault tobalance
- each custom weight has a
- Supported locales are English (
en) and Danish (da).
- Models:
grouper-app/src/app/models/ - Services:
grouper-app/src/app/core/services/ - Algorithms:
grouper-app/src/app/core/algorithms/ - Session feature UI:
grouper-app/src/app/features/sessions/ - i18n files:
grouper-app/src/assets/i18n/
Note: Documentation-only changes do not affect application behavior. No-op note: repository workflow validation change.