How angelabauer/python-coding-challenges works
Project type and purpose
• This is a React‐based Single‐Page Application (SPA) that renders a set of Python coding challenges entirely in the browser.
• It ships as a static site (build/ folder) and is designed to be hosted (e.g., GitHub Pages).
• Content (all challenges and metadata) lives in the challenges/ folder and is preprocessed by a Node.js script into a combined JSON that the client consumes.
File structure
• Top-Level:
• package.json, package-lock.json – front-end dependencies and scripts
• public/ – static HTML and manifest for the SPA
• src/ – React source code (components, styles, assets)
• build/ – output of npm run build (static HTML, CSS, JS bundles)
• challenges/ – individual challenge directories (lesson.md, lesson_settings.json, lesson_tests.py, main.py)
• generate-challenge-json.js – Node script that reads challenges/ and emits a single challenges.json
README for additional insights
• The generate-challenge-json.js script consolidates lessons into a JSON that the React app imports.
• Running locally involves npm install, npm start, and for production npm run build.