Repository navigation
Spec 03 Repository Layout
github-actions[bot] edited this page Oct 14, 2026
·
1 revision
Section of Quizzivy — Frontend Portal & Data Model Specification · Previous · Next
web/src/
├─ app/ # shell: providers, router, error boundaries, guards/
├─ features/
│ ├─ auth/
│ ├─ join/ # NEW: public class-code join flow
│ ├─ tests/ # admin: authoring
│ ├─ question-bank/
│ ├─ media/ # NEW: upload widget + asset picker
│ ├─ assignments/
│ ├─ attempts/ # admin: monitoring + grading
│ ├─ integrity/
│ ├─ students/
│ ├─ classes/
│ ├─ take-test/ # student: the engine
│ └─ results/
├─ components/
│ ├─ ui/ # shadcn primitives
│ └─ shared/
├─ layouts/ # TeacherLayout (shell/), StudentLayout, FocusLayout
├─ lib/ # api/, i18n/, utils/, config.ts
├─ hooks/ stores/ styles/ main.tsx
Feature folder convention (src/features/<name>/): api.ts, schemas.ts, components/, pages/, store.ts (optional), index.ts (public exports only). Features import each other only via index.ts. components/shared never imports from features/.
Section of Quizzivy — Frontend Portal & Data Model Specification · Previous · Next
Generated from docs/quizzivy-spec-v0.3.md. Edit that file in the repository; changes made on this page are overwritten.
Generated from the repository's documentation on every push to develop.
Start here
Product
Implementation plan
- 00 Architecture overview
- 10 Phase 0: Scaffold and contract
- 11 Phase 1: Auth, join, shells
- 12 Phase 2: Admin authoring
- 13 Phase 3: Assign and take
- 14 Phase 4: Grade and results
- 15 Phase 5: Hardening
- 16 Phase 4.5: The student at a desk
- 17 Word import: milestone plan
- 18 Word import: teacher workflow
- 19 Versioned content contract
- 20 Data model
- 30 Risk register
- 40 Open items
- 50 Non-functional requirements
- 60 Backend architecture
- 91 September 2026 issue remediation
- 92 Student layouts and interaction rules
Redesign (Phase R)
- 70 Redesign overview
- 71 R1: Foundations (v0.7.0)
- 72 R2: Access (v0.8.0)
- 73 R3: Student console (v0.9.0)
- 74 R4: Teacher workspace (v0.10.0)
- 74d D4: Deck update (v0.11.0)
- 74e E1: Moving a question across a group
- 75 R5: Admin console and email (v0.12.0)
- 76 R6: Question types and scoring (v0.13.0)
- 77 R7: Collaboration (v0.14.0)
- 78 R8: Schedule (v0.15.0)
- 79 R9: Insights (v0.16.0)
- 80 R10: Learn (v0.17.0)
- 81 R11: Landing, leads, v1.0 (v1.0.0)
Setup and operations
- CI
- Deploying
- DNS for quizzivy.com
- Google OAuth client
- Production operations
- Cloudflare R2 bucket
- Word import worker
- R4 rehearsal on a Neon branch
Design
Team
- Agent team
- Verification environment
- Team ledger
- R4 readiness
- R4 verification strategy
- T-R4.51 browser verification
Code READMEs