{"id":48468666,"url":"https://github.com/vektorprogrammet/mono-web","last_synced_at":"2026-04-07T05:32:07.391Z","repository":{"id":342451900,"uuid":"1174011221","full_name":"vektorprogrammet/mono-web","owner":"vektorprogrammet","description":"Turborepo monorepo — homepage, dashboard, API, Symfony server, SDK","archived":false,"fork":false,"pushed_at":"2026-03-21T11:31:17.000Z","size":53288,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-21T19:27:30.766Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vektorprogrammet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-06T01:22:23.000Z","updated_at":"2026-03-21T11:31:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vektorprogrammet/mono-web","commit_stats":null,"previous_names":["vektorprogrammet/mono-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vektorprogrammet/mono-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vektorprogrammet%2Fmono-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vektorprogrammet%2Fmono-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vektorprogrammet%2Fmono-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vektorprogrammet%2Fmono-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vektorprogrammet","download_url":"https://codeload.github.com/vektorprogrammet/mono-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vektorprogrammet%2Fmono-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31501903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-07T05:32:06.613Z","updated_at":"2026-04-07T05:32:07.380Z","avatar_url":"https://github.com/vektorprogrammet.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# monoweb\n\nTurborepo monorepo for [Vektorprogrammet](https://vektorprogrammet.no) — a Norwegian university tutoring program connecting STEM students with primary schools.\n\n## Project Structure\n\n```\nmonoweb/\n├── apps/\n│   ├── homepage/    # Public website (React Router, Tailwind, daisyUI)\n│   ├── dashboard/   # Admin dashboard (React Router, Tailwind, shadcn)\n│   ├── api/         # TypeScript API (Express 5, Drizzle, PostgreSQL)\n│   └── server/      # PHP backend (Symfony 6.4, API Platform 3.4, MySQL)\n├── packages/\n│   └── sdk/         # Type-safe API client (@vektorprogrammet/sdk)\n└── docs/\n    ├── adr/         # Architecture Decision Records\n    ├── migration/   # Migration roadmap and state contracts\n    └── plans/       # Implementation plans\n```\n\nThe PHP server (`apps/server`) is the current production backend. The TypeScript API (`apps/api`) and SDK (`packages/sdk`) are part of an incremental migration — see [docs/migration/](docs/migration/) for details.\n\n## Getting Started\n\n```bash\nbun install\n```\n\n### Local Development\n\nStart the frontend apps (homepage + dashboard):\n\n```bash\nbun run dev\n```\n\nStart the PHP server with Docker (MySQL included):\n\n```bash\ndocker compose up server mysql\n```\n\n| App | URL | Start command |\n|-----|-----|---------------|\n| Homepage | http://localhost:5173 | `bun run dev:homepage` |\n| Dashboard | http://localhost:5174 | `bun run dev:dashboard` |\n| PHP Server | http://localhost:8000 | `bun run dev:server` (or Docker) |\n| TS API | http://localhost:3000 | `bun run dev:api` |\n\n### Database Setup\n\nThe project has two databases:\n\n- **MySQL 8.0** for the PHP server — provisioned automatically by `docker compose up`\n- **PostgreSQL 16** for the TS API — provisioned by `docker compose up` or set `DATABASE_URL` in `apps/api/.env`\n\n## Scripts\n\n| Command | Purpose |\n|---------|---------|\n| `bun run dev` | Start homepage + dashboard |\n| `bun run dev:homepage` | Start homepage only |\n| `bun run dev:dashboard` | Start dashboard only |\n| `bun run dev:api` | Start TS API only |\n| `bun run dev:server` | Start PHP server only |\n| `bun run build` | Build all packages |\n| `bun run lint` | Lint all packages (oxlint) |\n| `bun run test` | Run all test suites |\n| `bun run check` | Run oxlint + oxfmt |\n| `bun run check-types` | TypeScript type checking |\n\nPHP server commands run via composer, not turbo:\n\n```bash\ncd apps/server\ncomposer test       # PHPUnit (1001 tests)\ncomposer lint       # PHP-CS-Fixer\ncomposer analyse    # PHPStan\n```\n\n## SDK\n\n`@vektorprogrammet/sdk` is a type-safe API client auto-generated from the Symfony OpenAPI spec.\n\n```bash\nturbo run generate   # Regenerate types from OpenAPI spec\n```\n\n```typescript\nimport { createClient, createQueryApi } from \"@vektorprogrammet/sdk\";\n\nconst api = createClient(\"http://localhost:8000\");\nconst { data } = await api.GET(\"/api/public/departments\");\n```\n\nSee [packages/sdk/](packages/sdk/) for full usage.\n\n## Tooling\n\n- **Package manager:** Bun\n- **Monorepo:** Turborepo\n- **Linting/formatting:** oxlint + oxfmt\n- **Commits:** [Conventional Commits](https://www.conventionalcommits.org/)\n- **SDK publishing:** Changesets (npm: `@vektorprogrammet/sdk`)\n- **CI:** GitHub Actions — parallel TS (turbo) + PHP (composer) jobs\n- **Git hooks:** Pre-commit runs lint, build, and changeset checks (`.githooks/`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvektorprogrammet%2Fmono-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvektorprogrammet%2Fmono-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvektorprogrammet%2Fmono-web/lists"}