How nicolascrr/franol works
Frañol is a bilingual French–Spanish learning app. Learners choose a language, authenticate, manage vocabulary/expressions/conjugations, and practice through quizzes; quiz presets, discovery, AI-generated explanations and conjugations extend that workflow. The graph includes the documented shared-password session flow and Supabase-backed content/presets. Some page and route implementations were not sampled, so their UI-to-API relationships are shown only as unverified dashed links.
Main entry points: dashboard/page.tsx Dashboard · content/page.tsx Content management · setup/page.tsx Practice setup · quiz/page.tsx Quiz session
Components 27
Learner experience
- Language choice
src/app/page.tsx - Dashboard
src/app/dashboard/page.tsx - Release notes
src/components/dashboard/Changelog.tsx
Content and practice
- Content management
src/app/dashboard/content/page.tsx - Add learning items
src/app/dashboard/add/page.tsx - Practice setup
src/app/dashboard/practice/setup/page.tsx - Quiz session
src/app/dashboard/practice/quiz/page.tsx - Quiz results
src/app/dashboard/practice/results/page.tsx - Content discovery
src/app/dashboard/practice/discovery/page.tsx - Quiz presets
src/app/dashboard/practice/presets/page.tsx - Quiz logic
src/lib/quiz.ts - Preset API
src/app/api/quiz-presets/route.ts
AI learning services
- AI endpoints
src/app/api/ai/generate-batch/route.ts - Gemini client
src/lib/ai/client.ts - Localized prompts
src/lib/prompts/index.ts
Authentication
- Login page
src/app/login/page.tsx - Route protection
src/middleware.ts - Auth endpoints
src/app/api/auth/login/route.ts - Signed sessions
src/lib/auth/session.ts
Data and language layer
- Supabase data access
src/lib/supabase/client.ts - Locale context
src/contexts/LocaleContext.tsx - Bilingual field access
src/lib/lang.ts - Input validation
src/lib/auth/input-validation.ts - Release data
src/data/releases.ts
Other components
- Learner
- Supabase
- Gemini API
Connections 28
- Learner → Language choice: chooses language
- Learner → Login page: signs in
- Login page → Auth endpoints: submits credentials
- Auth endpoints → Signed sessions: signs session
src/app/api/auth/login/route.ts - Route protection → Signed sessions: verifies session
src/middleware.ts - Learner → Dashboard: uses app
- Dashboard → Content management: opens content
- Dashboard → Add learning items: adds items
- Dashboard → Practice setup: starts practice
- Practice setup → Quiz session: configures quiz
- Quiz session → Quiz logic: uses quiz logic
src/lib/quiz.ts - Quiz session → Quiz results: shows results
- Practice setup → Content discovery: offers discovery
- Practice setup → Quiz presets: offers presets
- Content management → Supabase data access: reads and writes
src/app/dashboard/content/page.tsx - Quiz logic → Supabase data access: accesses data
src/lib/quiz.ts - Supabase data access → Supabase: queries
- Quiz presets → Preset API: manages presets
- Preset API → Supabase: reads and writes
src/app/api/quiz-presets/route.ts - Quiz session → AI endpoints: requests generation
- AI endpoints → Input validation: sanitizes prompt
src/app/api/ai/generate-batch/route.ts - AI endpoints → Localized prompts: builds quiz prompt
src/app/api/ai/generate-batch/route.ts - AI endpoints → Gemini client: requests completion
src/app/api/ai/generate-batch/route.ts - Gemini client → Gemini API: calls Gemini
- Content management → Locale context: uses locale
src/app/dashboard/content/page.tsx - Content management → Bilingual field access: reads language fields
src/app/dashboard/content/page.tsx - Quiz logic → Bilingual field access: uses language helpers
src/lib/quiz.ts - Release notes → Release data: renders release data
src/components/dashboard/Changelog.tsx