How papillonapp/papillon works
Papillon is a mobile school-life app for viewing and managing school information across several education-service providers, with local account and school-data storage. The user-facing flow starts with onboarding and account setup, then screens request school data through a shared service manager and display it in areas such as the home, timetable, grades, and tasks. The graph also retains news, attendance, messaging, canteen, and local calendar capabilities visible in the repository. Some links are documented only by the source index; unsampled wiring is not inferred.
Main entry points: index.ts Service manager · useHomework.ts Homework storage · shared Shared service data · useHomeData.ts Home data hook
Components 25
Onboarding and accounts
- Onboarding flow
app/(onboarding) - Account state
stores/account/index.ts
School service integration
- Service manager
services/shared/index.ts - Shared service data
services/shared - Pronote adapter
services/pronote/index.ts - EcoleDirecte adapter
services/ecoledirecte/index.ts - Skolengo adapter
services/skolengo/index.ts - Other provider adapters
services
Local data
- Database provider
database/DatabaseProvider.tsx - Homework storage
database/useHomework.ts - Safe transactions
database/utils/safeTransaction.ts - School-data models
database/models
School life features
- Home dashboard
app/(tabs)/index - Home data hook
app/(tabs)/index/hooks/useHomeData.ts - Calendar and timetable
app/(tabs)/calendar - Grades
app/(tabs)/grades - Grades data hook
app/(tabs)/grades/hooks/useGradesData.ts - Tasks and homework
app/(tabs)/tasks - Homework data hook
app/(tabs)/tasks/hooks/useHomeworkData.ts - News
app/(features)/(news) - Attendance
app/(features)/attendance.tsx - School cards
app/(features)/(cards) - Local calendar imports
services/local/ical.ts
Other components
- Student or family
- School platforms
Connections 31
- Student or family → Onboarding flow: starts setup
README.md - Onboarding flow → Account state: configures accounts
- Home dashboard → Home data hook: loads dashboard
- Home data hook → Service manager: requests school data
app/(tabs)/index/hooks/useHomeData.ts - Home data hook → Homework storage: reads homework
app/(tabs)/index/hooks/useHomeData.ts - Grades → Grades data hook: loads grades
- Grades data hook → Service manager: requests grades
app/(tabs)/grades/hooks/useGradesData.ts - Tasks and homework → Homework data hook: loads homework
- Homework data hook → Service manager: requests homework
app/(tabs)/tasks/hooks/useHomeworkData.ts - Homework data hook → Homework storage: reads and writes
app/(tabs)/tasks/hooks/useHomeworkData.ts - Service manager → Homework storage: caches results
services/shared/index.ts - Homework storage → Database provider: opens database
database/useHomework.ts - Homework storage → Safe transactions: writes safely
database/useHomework.ts - Database provider → School-data models: registers models
database/DatabaseProvider.tsx - Service manager → Shared service data: uses shared types
services/shared/index.ts - Pronote adapter → Shared service data: implements contracts
services/pronote/index.ts - EcoleDirecte adapter → Shared service data: implements contracts
services/ecoledirecte/index.ts - Skolengo adapter → Shared service data: implements contracts
services/skolengo/index.ts - Service manager → Pronote adapter: dispatches requests
services/shared/index.ts - Service manager → EcoleDirecte adapter: dispatches requests
services/shared/index.ts - Service manager → Skolengo adapter: dispatches requests
services/shared/index.ts - Service manager → Other provider adapters: supports providers
services/shared/index.ts - School platforms → Pronote adapter: serves data
- School platforms → EcoleDirecte adapter: serves data
- School platforms → Skolengo adapter: serves data
- Calendar and timetable → Local calendar imports: imports calendars
- Service manager → Calendar and timetable: provides timetable
- Service manager → News: provides news
- Service manager → Attendance: provides attendance
- Service manager → Grades: provides grades
app/(tabs)/grades/hooks/useGradesData.ts - Service manager → School cards: provides balances