{"id":49203223,"url":"https://github.com/studiohyperdrive/duaal-leren_2026","last_synced_at":"2026-04-25T18:00:46.273Z","repository":{"id":352458236,"uuid":"1215183669","full_name":"studiohyperdrive/duaal-leren_2026","owner":"studiohyperdrive","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-23T14:11:36.000Z","size":5204,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T17:33:15.418Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/studiohyperdrive.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-04-19T15:36:15.000Z","updated_at":"2026-04-23T14:12:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/studiohyperdrive/duaal-leren_2026","commit_stats":null,"previous_names":["robbebierebeeck/duaal-leren_starter_2026","studiohyperdrive/duaal-leren_2026"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/studiohyperdrive/duaal-leren_2026","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/studiohyperdrive%2Fduaal-leren_2026","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/studiohyperdrive%2Fduaal-leren_2026/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/studiohyperdrive%2Fduaal-leren_2026/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/studiohyperdrive%2Fduaal-leren_2026/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/studiohyperdrive","download_url":"https://codeload.github.com/studiohyperdrive/duaal-leren_2026/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/studiohyperdrive%2Fduaal-leren_2026/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32271243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T09:15:33.318Z","status":"ssl_error","status_checked_at":"2026-04-25T09:15:31.997Z","response_time":59,"last_error":"SSL_read: 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-23T16:31:28.765Z","updated_at":"2026-04-25T18:00:46.255Z","avatar_url":"https://github.com/studiohyperdrive.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Duaal Leren Starter 2026\n\nA React + TypeScript starter used for the **enterprise production-ready React** workshop. The repo demonstrates conventions before code: a feature-module layout, strict TypeScript, ESLint + Prettier with a pre-commit hook, and TanStack Router/Query installed but unwired so students can implement them during the workshop.\n\n## Prerequisites\n\n- [nvm](https://github.com/nvm-sh/nvm) (or any tool that reads `.nvmrc`)\n- npm 10+\n\n## Getting started\n\n```bash\nnvm use            # picks up Node version from .nvmrc\nnpm install        # also installs the husky pre-commit hook via the prepare script\ncp .env.example .env.local\nnpm run dev\n```\n\nOpen the URL Vite prints (default `http://localhost:5173`).\n\n## Scripts\n\n| Command                | What it does                                           |\n| ---------------------- | ------------------------------------------------------ |\n| `npm run dev`          | Vite dev server with HMR                               |\n| `npm run build`        | Type-check then produce a production bundle in `dist/` |\n| `npm run preview`      | Serve the built bundle locally                         |\n| `npm run typecheck`    | Run the TypeScript compiler in no-emit mode            |\n| `npm run lint`         | Run ESLint over the project                            |\n| `npm run lint:fix`     | Run ESLint with `--fix`                                |\n| `npm run format`       | Format every file with Prettier                        |\n| `npm run format:check` | Verify formatting in CI without writing                |\n\n## Folder structure\n\n```\nsrc/\n  main.tsx              # React 19 root\n  App.tsx               # placeholder shell\n  env.ts                # typed import.meta.env wrapper (boundary pattern)\n\n  shared/               # cross-cutting code, reusable by any module\n    components/         # generic UI primitives\n    hooks/              # generic hooks\n    lib/                # framework-agnostic helpers\n    types/              # cross-cutting type aliases\n\n  modules/              # one folder per business/domain module\n    counter/            # the example module shipped with the starter\n      pages/            # what a route renders\n      components/       # internal UI pieces\n      hooks/            # internal state\n      types.ts\n      index.ts          # public API barrel — only this is importable from outside\n```\n\n### Path aliases\n\nConfigured in `tsconfig.app.json` and mirrored in `vite.config.ts`:\n\n| Alias        | Resolves to     | Use for                   |\n| ------------ | --------------- | ------------------------- |\n| `~/*`        | `src/*`         | Anywhere inside `src/`    |\n| `~shared/*`  | `src/shared/*`  | Reusable, non-domain code |\n| `~modules/*` | `src/modules/*` | A module's public API     |\n\n### Module conventions\n\n- Each module exposes a **public API** through its `index.ts`. Other code should import from `~modules/counter`, never from `~modules/counter/components/Counter`.\n- `shared/` is for code that has no business meaning. If a piece of code is about a domain concept, it belongs inside that module.\n- Pages are thin: they compose components and hooks from the same module.\n\n## What is intentionally _not_ set up\n\nThese pieces are installed or staged but **not wired**, so students implement them during the workshop:\n\n- **TanStack Router** — `@tanstack/react-router` is in `dependencies`. `App.tsx` does not yet render a `RouterProvider`.\n- **TanStack Query** — `@tanstack/react-query` is installed for the data-fetching session.\n\n## Pre-commit hook\n\n`husky` + `lint-staged` run Prettier on staged files before every commit. The hook is installed automatically by the `prepare` script after `npm install`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstudiohyperdrive%2Fduaal-leren_2026","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstudiohyperdrive%2Fduaal-leren_2026","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstudiohyperdrive%2Fduaal-leren_2026/lists"}