How thomas-le-goff/easy-pointer works
Easy Pointer is a web platform for learning C pointers through authenticated, progressive coding exercises. A student enters through the React app, signs in with GitHub, then edits and runs challenge code; the backend provides authentication and editor operations, while the frontend worker and WASM-4 execution layer support in-browser play. The graph combines sampled source references with README-documented capabilities; challenge internals and worker behavior were not sampled, so their detailed links are omitted or marked unverified.
Main entry points: App.jsx App routing · actions.py Auth endpoints · main.py FastAPI app · EditorPage.jsx Editor page
Components 23
Web application
- App routing
frontend/src/App.jsx - Auth context
frontend/src/contexts/AuthContext.jsx - Local storage
frontend/src/hooks/useLocalStorage.js - OAuth pages
frontend/src/pages/OAuth2/OAuth2ProviderPage.jsx - Auth layout
frontend/src/pages/AuthenticatedLayout.jsx - Editor page
frontend/src/pages/EditorPage.jsx - API client
frontend/src/hooks/useApiClient.js
Identity
- Auth endpoints
src/auth/actions.py - JWT handling
src/auth/auth.py - GitHub OAuth client
src/github/client.py
Backend services
- FastAPI app
src/main.py - User records
src/user/dao.py - User model
src/user/models.py - SQLite setup
src/database.py
Code execution
- Execution worker
frontend/src/userWorker.js - Editor endpoints
src/editor/actions.py - Code manager
src/editor/editor.py - Challenges
src/challenge - WASM sandbox
frontend/src/userWorker.js - WASM-4 starter
templates/w4/hello-world/src/main.c - WASM-4 API
templates/w4/hello-world/src/wasm4.h
Other components
- Student
- GitHub
Connections 27
- Student → App routing: uses
- App routing → Auth context: provides
frontend/src/App.jsx - App routing → OAuth pages: routes to
frontend/src/App.jsx - App routing → Auth layout: routes to
frontend/src/App.jsx - App routing → Editor page: routes to
frontend/src/App.jsx - Auth context → Local storage: persists via
frontend/src/contexts/AuthContext.jsx - OAuth pages → GitHub: authenticates with
- Auth layout → Editor page: gates access
frontend/src/App.jsx - Editor page → API client: requests via
frontend/src/pages/EditorPage.jsx - Editor page → Execution worker: starts
frontend/src/pages/EditorPage.jsx - API client → Auth context: invalidates session
frontend/src/hooks/useApiClient.js - API client → FastAPI app: sends API requests
- FastAPI app → Auth endpoints: registers router
src/main.py - FastAPI app → Editor endpoints: registers router
src/main.py - FastAPI app → SQLite setup: initializes
src/main.py - Auth endpoints → GitHub OAuth client: uses provider
src/auth/actions.py - Auth endpoints → User records: looks up users
src/auth/actions.py - Auth endpoints → JWT handling: issues tokens
- GitHub OAuth client → GitHub: requests OAuth
src/github/client.py - User records → User model: queries
src/user/dao.py - User records → SQLite setup: reads records
- Editor endpoints → Code manager: delegates to
src/editor/actions.py - Code manager → Challenges: loads template
- Code manager → WASM-4 starter: builds challenge
- Execution worker → WASM sandbox: executes in
frontend/src/userWorker.js - WASM-4 starter → WASM-4 API: includes
templates/w4/hello-world/src/main.c - WASM sandbox → Student: runs sandboxed code