SPECIFICATION · OPEN STEM REPOSITORY ARCHITECTURE STATIC-FIRST · ZERO NPM BLOAT · MIT / CC-BY-4.0
March For Sisterhood Youth STEM & Civic Organizing Zine
Technical Curriculum Standard

Open-Source Youth STEM Curriculum & Civic Repo Blueprints

Most youth hackathon projects die within ninety days because organizers choose cloud databases and fragile npm build chains that break as soon as student laptops leave the workshop. Static-first repositories eliminate hosting bills and let 14-year-old builders ship permanent public tools in a single weekend.

Core Repository Decision
Standardize youth STEM repositories on dependency-free HTML5, CSS custom properties, vanilla JavaScript, and static CSV/JSON data bundles under dual MIT (code) and CC-BY-4.0 (print curriculum) licensing. Every starter repository must boot locally via Python's built-in HTTP server without internet access, pass automated contrast and heading-outline checks, and export a print-ready stylesheet for zine handouts.

1. Why Static-First Repos Survive Classroom Constraints

Public school Chromebooks and library loaner laptops frequently restrict terminal package managers, block external CDN script hosts, and wipe local user profiles on reboot. When a workshop mentor introduces React toolchains or cloud API keys on Friday evening, half of Saturday morning disappears into proxy debugging and expired trial tokens.

By contrast, a three-file static architecture (index.html, style.css, app.js) paired with pre-cleaned civic CSV tables runs identically inside a browser tab opened from a 32 GB USB drive or served over python3 -m http.server. Students inspect real DOM state in DevTools, edit CSS print rules directly, and publish to static edge pages with zero ongoing server bills.

Data hygiene is taught before syntax. Before writing JavaScript filters, cohorts audit municipal datasets using simple Python scripts to verify column headers, flag missing census tracts, and strip any personally identifiable fields. This habit protects student contributors from accidentally publishing sensitive neighborhood contact sheets in public Git commits.

2. Five Starter Repository Blueprints

Each starter blueprint below maps directly to one civic problem domain commonly chosen by high school organizing cohorts. Mentors can clone the directory layout during camp prep and swap in local municipal CSV files without altering core JavaScript logic.

Repo Slug Civic Use Case Core Files & Footprint Offline Test Method License
civic-climate-csv Neighborhood heat-island & tree canopy audit 4 HTML / 18 KB JS / local GeoJSON python3 -m http.server MIT
mutual-aid-index Verified pantry, clinic transit & study-room hours 3 HTML / filter JS / JSON ledger Zero-network USB launch MIT
zine-cms-print Markdown to 2-color risograph booklet generator Python stdlib script + CSS @media print Chromium headless PDF CC-BY-4.0
transit-equity-audit Bus frequency & wheelchair ramp ledger Booktabs HTML tables + inline SVG chart Static file check MIT
sensor-serial-log Air quality PM2.5 micro-controller CSV logger MicroPython script + offline SVG plotter Local USB serial capture GPLv3

3. Standard Repository File Tree & CI Checks

Consistent folder naming allows a mentor arriving on Day 2 to help any student team within thirty seconds. Every camp repo keeps raw municipal downloads separate from sanitized JSON outputs, enforces self-hosted fonts to prevent blocked external requests, and includes a single-command accessibility check.

Standard Youth Civic Tech Repository Architecture REPO DIRECTORY CONTRACT · ZERO EXTERNAL BUILD DEPENDENCIES /data/raw-public.csv /data/clean-index.json /assets/fonts/*.woff2 /css/print-zine.css /js/filter-engine.js /LICENSE (MIT) /README.md Pre-Ship Cohort Gate 1. Zero PII in JSON 2. 4.5:1 Contrast Pass 3. 390px Mobile Overflow 0 4. Keyboard Tab Focus 5. Alt Text on Every Img RUNS IN < 3 SECONDS DUAL PUBLICATION Web: Static Edge Host Print: 16p Saddle-Stitch Offline: 32 GB USB Kit ZERO TRACKERS

4. Weekend 48-Hour Facilitation Cadence

Structure the workshop around four fixed six-hour sprints rather than open-ended lectures. On Saturday morning, limit slides to twenty minutes and move straight into paper wireframing and public dataset selection. By Saturday afternoon, every pair of youth builders commits a working static page to their chapter repository so nobody spends Sunday evening fighting blank screens.

Sunday morning focuses on defensive accessibility and mobile viewport verification at 390 pixels wide, followed by a two-hour zine editorial sprint where teams write one plain-language summary card describing what their data shows and how neighbors can act on it. Printing the physical booklet before the final showcase gives families and local librarians a tangible artifact even if campus Wi-Fi drops during demos.

5. Offline USB Lab Kit & Mentor Git Workflow

When running camps in rural libraries or community centers with capped cellular hotspots, load a single 32 GB USB flash drive per table with an offline copy of MDN Web Docs HTML/CSS references, Python 3 installers, sample municipal CSV archives, and the five starter repository zip bundles. A pair of mentors can bootstrap twenty workstations in under ten minutes without downloading a single megabyte over Wi-Fi.

Keep Git version control approachable for beginners by pairing each table of four students onto one shared mentor-supervised branch before merging into main. Instead of teaching complex rebase recovery during a 48-hour sprint, mentors run a predictable three-command rhythm (git status, git add, git commit -m) every ninety minutes. Every pull request triggers a local Python verification script that checks three non-negotiable shipping standards: valid relative asset paths, zero broken alt attributes on photos or SVG diagrams, and zero horizontal overflow on 390-pixel mobile viewports.

To keep student projects genuinely useful after camp closes, every starter repository ships with a plain-English HANDOFF.md checklist specifying who owns domain renewal, where the raw municipal CSV source URL lives, and how a future cohort can update neighborhood figures without touching layout stylesheets. Combining clean MIT-licensed starter code with a printable CC-BY-4.0 zine ensures that local librarians, teachers, and youth organizers can fork and remix the curriculum year after year with zero vendor lock-in.

6. Accessibility & Keyboard Navigation Standards

Every student-built civic tool is tested for keyboard-only tab navigation, visible focus rings, semantic landmark regions, and minimum 4.5:1 foreground-to-background text contrast before showcase demos begin. Replacing mouse-only hover menus and unlabeled icon buttons with native HTML buttons and descriptive labels teaches teenagers that public civic software only works when disabled neighbors, older residents, and screen-reader users can operate every control independently. Mentors model these habits during code review by reading each pull request alongside a live keyboard walkthrough.

ARCHIVE NOTE · LEGACY /toolkit, /curriculum & /resources ANCHOR

Preserving Digital Organizing Toolkits as Open Code

In September and October 2019, #MarchForSisterhood organizers circulated downloadable social-media and community organizing guides alongside Mashable and Refinery29 features. This section expands that digital organizing spirit into permanent, inspectable open-source STEM repositories licensed under MIT and CC-BY-4.0.