# AlloFlow Document Remediation **Category:** ๐Ÿ’ป Developer Tools **Repository:** https://github.com/Apomera/AlloFlow **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/alloflow-document-remediation ## Description Local-first document accessibility remediation using the canonical AlloFlow app pipeline. ## Claude Desktop Quick Installation Heuristic fallback โ€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "alloflow-document-remediation": { "command": "npx", "args": ["-y","alloflow-document-remediation"] } } ``` ## Documentation & README
AlloFlow open-source AI classroom assistant logo # AlloFlow (v1.2) **Adaptive Levels, Layers, & Outputs โž” Flexible Learning Options for Whole-Student Education** [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE) [![Local-First Architecture](https://img.shields.io/badge/Architecture-Local--First-brightgreen.svg)](#-local-first-desktop-and-school-box) [![Privacy: FERPA-aligned deployment](https://img.shields.io/badge/Privacy-FERPA--aligned_deployment-red.svg)](#-privacy--ferpa-aligned-deployment) [![Accessibility: WCAG 2.2 AA-oriented](https://img.shields.io/badge/Accessibility-WCAG_2.2_AA--oriented-blue.svg)](#-accessibility) [![UDL Aligned](https://img.shields.io/badge/UDL-Aligned-purple.svg)](#-udl-alignment)
--- ## ๐Ÿš€ What is AlloFlow? AlloFlow is an **open-source, privacy-first AI classroom assistant and instructional differentiation engine** built for educators, special education teams, and school psychologists. Use the keyless Google-managed Gemini Canvas path with no installation, or run AlloFlow Desktop for a local-first teacher-laptop workflow. AlloFlow can transform source material into interactive, differentiated learning resources. **No AlloFlow software subscription. Local classroom flows can run without student accounts or required PII. Cloud-provider terms, data handling, and costs depend on the deployment you choose.** **Official AlloFlow website:** [apomera.github.io/AlloFlow](https://apomera.github.io/AlloFlow/) **Official source repository:** [github.com/Apomera/AlloFlow](https://github.com/Apomera/AlloFlow) **Official project facts:** [apomera.github.io/AlloFlow/about.html](https://apomera.github.io/AlloFlow/about.html) — maintained identity, version, license, privacy boundaries, and guidance for distinguishing the canonical project from forks. **Search identity:** AlloFlow is a free open-source AI classroom assistant for differentiated instruction, UDL, accessibility, AAC communication, STEM/SEL tools, RTI, and local-first school deployments. **Current inventory (verified August 22, 2026):** the repository registry check reports 145 STEM tool registrations and 71 SEL tool registrations; the STEM directory contains 144 plugin files because one file registers an additional tool. The broader July 3 codebase review remains the dated source for architecture and size estimates. AlloFlow Desktop is the everyday local-first path, while the Docker School Box stack is optional server/appliance infrastructure. See [docs/codebase_review_2026-07-03.md](https://github.com/Apomera/AlloFlow/blob/HEAD/docs/codebase_review_2026-07-03.md), [docs/code_size_inventory_2026-07-03.csv](https://github.com/Apomera/AlloFlow/blob/HEAD/docs/code_size_inventory_2026-07-03.csv), [docs/competitive_positioning_review_2026-07-03.md](https://github.com/Apomera/AlloFlow/blob/HEAD/docs/competitive_positioning_review_2026-07-03.md), and [desktop/README.md](https://github.com/Apomera/AlloFlow/blob/HEAD/desktop/README.md). ๐Ÿ”— **[Launch AlloFlow](https://apomera.github.io/AlloFlow/launch.html)** --- ## โšก Quick Start 1. **[Click to launch](https://apomera.github.io/AlloFlow/launch.html)** โ€” opens the Gemini Canvas path (eligible Google account required; availability and school administrator settings apply) 2. **Paste your lesson text** into the Source Material box, or let the AI generate from a topic 3. **Click Fullpack** โ€” leveled text, glossary, quizzes, and scaffolds generated in one click 4. **Start a Live Session** to push resources to student devices in real-time > ๐Ÿ’ก For local-first use on a teacher laptop, see [desktop/README.md](https://github.com/Apomera/AlloFlow/blob/HEAD/desktop/README.md). For school-owned server/appliance experiments, see [School Box](#-local-first-desktop-and-school-box) below. > > ๐Ÿซ **District decision-maker?** See the 2-page [Admin Brief](https://github.com/Apomera/AlloFlow/blob/HEAD/AdminBrief.md) โ€” cost comparison, privacy/compliance, and pilot-path summary. ### Agent-authored AlloPacks An agent can author the same portable resource-pack structure without opening the AlloFlow UI. The local Agent Core MCP accepts agent-generated resource history, validates renderer-critical shapes and privacy safeguards, creates a teacher-review preview, and exports a .allopack.json payload. It does not silently call a model, read API keys, upload source text, publish content, or write arbitrary paths. See the [MCP connector guide](https://github.com/Apomera/AlloFlow/blob/HEAD/desktop/mcp/README.md), the [AlloPack specification](https://github.com/Apomera/AlloFlow/blob/HEAD/docs/ALLOPACK_FORMAT_SPEC.md), and the reusable [AlloFlow resource-pack authoring skill](https://github.com/Apomera/AlloFlow/blob/HEAD/agent_skills/alloflow-resource-pack-authoring/SKILL.md). --- ## Product tour - [Promotion site](https://apomera.github.io/AlloFlow/) -- overview, deployment paths, and current evidence - [Official project facts](https://apomera.github.io/AlloFlow/about.html) -- canonical repository, current release, license, authorship, and deployment boundaries - [Tool finder](https://apomera.github.io/AlloFlow/tools.html) -- search by goal, source requirement, AI need, and access path - [Document remediation](https://apomera.github.io/AlloFlow/remediation.html) -- pipeline, evidence boundaries, portable Skill, and connector status - [Ways to use AlloFlow](https://apomera.github.io/AlloFlow/ways-to-use.html) -- compare Gemini Canvas, browser, Desktop, Skill, and connector paths - [Accessibility white paper](https://apomera.github.io/AlloFlow/whitepaper.html) -- standards context, architecture, privacy boundaries, and evidence - [Feedback](https://apomera.github.io/AlloFlow/feedback.html) -- safe routes for ideas, bugs, accessibility barriers, and de-identified use stories - [Feature catalog](https://apomera.github.io/AlloFlow/features.html) -- documented capabilities organized around UDL - [Student experience](https://apomera.github.io/AlloFlow/students.html) -- learner-facing tools and accessibility supports - [District brief](https://apomera.github.io/AlloFlow/for-districts.html) -- planning, privacy, accessibility, and pilot considerations > Screenshots change quickly as the interface evolves. Use the current promotion pages and launch flow for the latest maintained product tour. --- ## โœจ Key Features ### ๐ŸŽ“ For Teachers | Feature | Description | |---------|-------------| | **Leveled Text & Scaffolds** | Instantly rewrite any source to K-12 plus higher-education/adult reading levels with bilingual side-by-side views, cloze passages, and scaffolded writing frames | | **Fullpack Generation** | One click generates glossary, leveled reader, quiz, visual organizer, and lesson plan simultaneously | | **Live Session (Classroom Sync)** | Push your screen to all student devices in real-time โ€” Teacher Paced or Student Paced modes | | **Group Differentiation** | Assign different resources to different student groups simultaneously during a live session | | **Lesson Plan Builder** | Auto-synthesizes all generated resources into a scripted, standard-aligned lesson plan | | **Standards Alignment** | Align to CCSS, NGSS, CASEL, or any state standard; AI audits its own output for compliance | | **Smart Profiles** | Save configurations (e.g., "Grade 5 + ESL") for one-click switching across lessons | | **Multimodal Input** | Source from text paste, URL, PDF/image OCR, audio/video transcription, or AI generation | | **AlloStudio** | Born-accessible flyer/worksheet/digital-art studio with real text, explicit reading order, required alt/decorative image states, and provenance-aware process history | | **Open Groove Studio** | Browser-based groovebox/composition studio for rhythm, synthesis, samples, notation concepts, and license-aware classroom music creation | | **Cinematic Studio** | Agentic document โ†’ video generator: source-grounded storyboard JSON, captions + translation, and client-side rendering (WebCodecs / Remotion) โ€” no render server required (Educator Hub โ†’ ๐ŸŽฌ) | | **Professional Development** | Community-authored PD modules with AI co-authoring, completion tracking, and certificates (Educator Hub โ†’ Community Catalog โ†’ Professional Development) | ### ๐ŸŽฎ For Students | Feature | Description | |---------|-------------| | **Adventure Mode** | Choose-your-own-adventure RPG with XP, inventory, dynamic Imagen-generated scenes, and Storybook export | | **Boss Battle** | Whole-class cooperative quiz game โ€” correct answers deal damage to the boss | | **Escape Room** | Team-based puzzle challenges with teacher-controlled hints and timed escape tracking | | **Review Game** | Jeopardy-style competitive review with teams and real-time scoring | | **Democracy Mode** | Class votes on the answer; majority response is submitted | | **Gamification Engine** | XP, levels, streaks, and badges earned across all activities | | **Interactive Glossary** | Memory Match, Word Search, Crossword, Bingo, Scramble โ€” all generated instantly from the vocabulary list | | **Immersive Reader** | RSVP speed reader, karaoke highlighting, bionic reading, and adjustable reading ruler | ### ๐Ÿฉบ For Special Educators & BCBAs | Feature | Description | |---------|-------------| | **BehaviorLens** | Full FBA/BIP suite โ€” ABC data collection, frequency/interval tracking, IOA calculator (5 methods), scatterplot analysis, preference assessments (MSWO, Paired, Free Operant) | | **Quick-Fill AI** | Type a natural language observation; AI auto-structures it into Antecedent, Behavior, Consequence with function hypothesis | | **Intervention Templates** | DRO protocols, token economies, behavior contracts, SMART goals, FCT templates, de-escalation toolkit | | **Restorative Language** | Affirmative Glossary translates clinical ABA terms to person-first language throughout; Restorative Questions generated from each logged incident | | **Symbol Studio** | Full AAC platform โ€” AI-generated PCS-style symbols (Imagen + image-to-image), board builder, visual schedules, social stories (Carol Gray format), 8 Quick Board types, Symbol Quest (4 game modes), Symbol Search (auditory-to-visual training), Word Garden (vocabulary growth tracking), IEP goal tracking with auto-recorded trials, partner-assisted scanning, multilingual boards (14 languages), per-cell parent voice recording, up to 8 student profiles | | **Word Sounds Studio** | 17 literacy activities across five strands โ€” 6 phonemic awareness (counting, segmentation, isolation, blending, sound sort, manipulation), 4 syllable & rhyme, 3 phonics, 3 spelling, 1 handwriting with grade-normed adaptive difficulty and 6 achievement badges | | **StoryForge** | 6-phase scaffolded creative writing with AI illustration (Imagen), narration (8 TTS voices), grading with custom rubrics, 18-language support, writing sprint timers, AI grammar/style coaching, revision tracking, and comic panel stickers | ### ๐Ÿง  For School Psychologists | Feature | Description | |---------|-------------| | **Report Writer Wizard** | 10-step guided wizard for synthesizing standardized assessment data into bilingual psychoeducational reports with triangulated generation (N parallel passes, best-of-N by evidence coverage), self-healing dual-pass accuracy audit, score-text verification, and cross-section consistency checking | | **Fact-Chunk Pipeline** | Immutable PII-scrubbing layer prevents AI hallucination or statistical misinterpretation during report generation; developmental norms cross-referencing (attention span, tantrum frequency, social play, vocabulary by age) | | **17 Assessment Presets** | WISC-V, WIAT-4, BASC-3 (Parent & Teacher), Vineland-3, BRIEF-2, Conners-4, WJ-IV COG & ACH, KABC-II, DAS-II, CELF-5, KTEA-3, SRS-2, GARS-3, BOT-2 | | **Student Analytics (RTI)** | Automated Tier 1/2/3 classification with aimline monitoring (4-week warning, 6-week critical alerts); ORF, Math Fluency, and Literacy CBM probes; Pearson correlation analysis; anomaly flagging; CSV export | | **Math Fluency Probes** | Kโ€“8 grade-normed DCPM arithmetic drills (addition, subtraction, multiplication, division) with error analysis and frustration detection | | **PDF Accessibility Pipeline** | Upload any PDF โ†’ up to 10-auditor triangulated AI audit (user-configurable, with stakeholder-perspective variants: screen-reader user, disability-rights advocate, Section 508, Title II ADA, JAWS/NVDA tester, etc.) โ†’ statistical agreement analysis (ICC-like, Cronbach-like) โ†’ one-click WCAG remediation via Vision API + Tesseract.js OCR (Gemini Vision fallback) for scanned/encrypted PDFs โ†’ axe-core 4.10 verification โ†’ self-healing auto-fix loop with regression-revert + SEM-based plateau detection โ†’ **native tagged-PDF output** (real `/StructTreeRoot` via pdf-lib, font embedding per PDF/UA ยง7.21.4.1) โ†’ in-app structural checks plus optional independent **PDF/UA-1 (ISO 14289-1) validation** through the local veraPDF demo/QA workflow โ†’ preview/edit with themes, brand matching, and AI image tools โ†’ **PII redaction** (true text removal) and **fillable AcroForm worksheets** โ†’ export as accessible PDF, HTML, ePub3, DAISY, ODT, or audio | --- ## STEM Lab (144 Plugin Files / 145 Registered Tool IDs) The STEM Lab is a dynamically-loaded suite of browser-based interactive tools. As verified by `node dev-tools/check_tool_registry.cjs` on August 22, 2026, the workspace contains **144 `stem_tool_*.js` files** and **145 registered STEM tool IDs** because one plugin file registers an additional tool. | Domain | Tools | |--------|-------| | **Math Fundamentals** | Fraction Lab, Area Model, Multiplication Table, Number Line, Math Manipulatives, Money Math, Coordinate Grid, Angle Explorer, 3D Volume Explorer, 3D Geometry Sandbox | | **Advanced Math** | Function Grapher, Inequality Grapher, Calculus Visualizer, Algebra CAS, Graphing Calculator, Probability Explorer, Unit Converter, Logic Lab | | **Life Science & Biology** | Cell Simulator, Human Anatomy, Brain Atlas, DNA Lab, Punnett Square, Virtual Dissection, Decomposer, Companion Planting Lab, Aquaculture & Ocean Lab, Ecosystem Simulator, Beehive Simulator | | **Earth & Space Science** | Rocks & Minerals, Water Cycle, Climate Explorer, Plate Tectonics, Solar System, Universe Timelapse, Galaxy Explorer, Moon Mission | | **Physics & Chemistry** | Wave Simulator, Physics Simulator, Circuit Builder, Chemical Equation Balancer, Molecule Builder, Titration Lab, Semiconductor Lab, Data Plotter | | **Technology & CS** | Coding Playground, Cyber Defense Lab, Data Studio | | **Creative & Design** | Architecture Studio, Art & Design Studio, Art Studio, Creative Studio, Game Studio | | **Social Studies & Life** | Economics Lab, Life Skills Lab | | **Simulation & Applied** | Kepler Colony, Behavior Shaping Lab, Flight Simulator, ATC Tower, Fire Ecology, Epidemic Simulator, World Builder, Science Lab, Geometry World | Each tool supports **Generate Drill** for instant related practice sets and saves/restores state with the session. --- ## ๐Ÿ’š SEL Hub (71 Interactive Tools) The SEL Hub provides **71 social-emotional learning tools** aligned with CASEL's core competencies and expanded AlloFlow categories such as self-direction, inner work, care of self, and stewardship: | Competency | Tools | |------------|-------| | **Self-Awareness** | Emotions Explorer, Strengths Inventory, Journal, Zones of Regulation, Growth Mindset Workshop | | **Self-Management** | Coping Strategies, Goals & Planning, Mindfulness, Transitions | | **Social Awareness** | Perspective Taking, Compassion, Culture Explorer, Upstander Training | | **Relationship Skills** | Friendship Builder, Conflict Resolution, Community, Teamwork, Restorative Circle | | **Responsible Decision-Making** | Decisions Lab, Ethical Reasoning Lab, Civic Action & Hope, Safety, Social Skills, Advocacy | Highlights include the **Growth Mindset Workshop** (Brain Science, Reframe Engine, Famous Yet Stories, AI Growth Coach, Letter to Future Me), **Restorative Circle** (5 circle types with Indigenous roots and talking pieces), **Ethical Reasoning Lab** (6 contemporary dilemmas, 6 ethical frameworks, stakeholder mapping), and **Culture Explorer** (80+ world cultures with AI-powered deep dives). --- ## ๐Ÿ” Privacy & FERPA-Aligned Deployment AlloFlow is designed so schools can keep student data inside the browser, teacher device, or school-controlled infrastructure. Cloud use is explicit and deployment-dependent. | Principle | Implementation | |-----------|----------------| | **No PII Required** | The tool does not require names, IDs, or identifying information | | **On-Device Storage** | Most ordinary work persists in browser local storage or downloaded project files; live-session cloud paths are designed to avoid durable student records | | **TeacherGate** | Clinical tools, grading rubrics, and answer keys are isolated behind educator verification | | **Local Voice/ASR Options** | Desktop can run local voice and transcription paths; web deployments can fall back to browser/local options when available | | **Local-First Options** | AlloFlow Desktop supports no-Docker local use and same-room LAN sessions; the Docker School Box stack is optional server/appliance infrastructure | > For districts using **Google Workspace for Education**: Canvas/Firebase coverage and student-privacy obligations depend on the district's account, contracts, retention settings, and actual use. AlloFlow is built to support FERPA-aligned deployments, but final compliance is a district/legal determination. --- ## ๐Ÿซ Local-First: Desktop and School Box > **Status as of August 1, 2026:** AlloFlow Desktop is the recommended local-first path for a teacher laptop or personal workstation. It serves the bundled app locally, manages keys and local AI settings, supports the built-in local engine, and can run same-room Desktop LAN sessions without Docker. The Docker School Box stack remains an optional server/appliance path for school-owned boxes, district/server experiments, and heavier air-gapped infrastructure. For everyday local use: ```powershell npm.cmd run desktop:check npm.cmd run desktop:smoke npm.cmd run desktop ``` For optional School Box server/appliance testing: ```bash # Clone the repository git clone https://github.com/apomera/AlloFlow.git # Start the optional Docker server stack docker-compose up -d ``` **What can run locally:** - **AlloFlow Desktop** โ€” bundled app hosting, local keys, diagnostics, built-in local engine, local ASR/TTS settings, and Desktop LAN sessions - **Optional Docker School Box stack** โ€” server/appliance services such as PocketBase, Ollama, Piper, SearXNG, Flux, and Nginx when a school wants managed local infrastructure - **LM Studio / Ollama / LocalAI** โ€” compatibility paths for users who already run those local providers - **PocketBase** โ€” local database replacing Firebase Hardware needs depend on the local model and service profile. See [desktop/README.md](https://github.com/Apomera/AlloFlow/blob/HEAD/desktop/README.md), [docker/README.md](https://github.com/Apomera/AlloFlow/blob/HEAD/docker/README.md), and [DEPLOY_YOUR_OWN.md](https://github.com/Apomera/AlloFlow/blob/HEAD/DEPLOY_YOUR_OWN.md). --- ## โ™ฟ Accessibility AlloFlow is built toward **WCAG 2.2 AA** with keyboard-first interaction patterns, automated audits, and per-tool accessibility gates. The current evidence set includes an interim v1.2 VPAT and a limited-scope WCAG 2.2 audit; neither is a product-wide certification. Compliance-sensitive deployments should still verify the exact workflow and exported artifacts they use. - **Dyslexia Fonts** โ€” OpenDyslexic, Lexend, Atkinson Hyperlegible - **Bionic Reading** โ€” bolds initial letters to guide decoding - **Voice options** โ€” word-for-word tracking through configured browser, cloud, Desktop, or optional local voice engines - **Color Overlays** โ€” Peach, Blue, Yellow tints for Irlen syndrome support - **Reading Ruler** โ€” mouse-following line isolation bar - **High Contrast & Dark Mode** - **Voice Dictation** โ€” speech-to-text on all input fields - **Keyboard-first coverage** โ€” core navigation and audited workflows support standard keyboard interaction; use the published audit and report any tool-specific gaps --- ## ๐Ÿ’ต Is It Really Free? **The software:** yes โ€” free and open-source under AGPL v3. **The Gemini API usage** depends on your deployment path: | Path | Software cost | API cost | What You Need | |------|---|---|---| | **Gemini Canvas** | No AlloFlow license fee | Subject to Google's current terms and quotas | A Google account; uses the host-provided keyless path | | **Firebase Hosting (Spark โ€” free tier)** | No AlloFlow license fee | Hosting and AI-provider usage are subject to current free-tier limits | A Firebase project plus a securely configured AI-provider path | | **Firebase Hosting (Blaze โ€” pay-as-you-go)** | No AlloFlow license fee | Provider and hosting charges vary by usage | Relevant for heavier workflows; see [DEPLOY_YOUR_OWN.md](https://github.com/Apomera/AlloFlow/blob/HEAD/DEPLOY_YOUR_OWN.md) and verify current provider pricing | | **AlloFlow Desktop** | Free | $0 for local engine use; cloud providers optional | Teacher laptop/workstation; no Docker required | | **School Box Server (optional Docker)** | Hardware cost only | $0 for local model paths; cloud providers optional | School-owned server/appliance stack | --- ## ๐ŸŽฏ UDL Alignment Every feature maps to [CAST's UDL Guidelines](https://udlguidelines.cast.org/): | UDL Principle | AlloFlow Tools | |---------------|----------------| | **Engagement** | Adventure Mode, Boss Battle, Escape Room, Democracy Mode, Symbol Quest, Symbol Search, StoryForge, Growth Mindset Workshop, Gamification Engine | | **Representation** | Leveled Text, Bilingual Views, Glossary with Icons, STEM Lab (144 plugin files / 145 registered IDs), SEL Hub (71 tools), TTS (40+ languages), Color Overlays, Bionic Reading, Symbol Studio AAC boards | | **Action & Expression** | Writing Scaffolds, StoryForge, Auto-Grader, Rubrics, Oral Fluency Coach, Dictation, QTI Export, Symbol Studio, Report Writer, PDF Pipeline | --- ## ๐Ÿ“š Documentation | Resource | Link | |----------|------| | ๐Ÿซ Admin Brief (for districts) | [AdminBrief.md](https://github.com/Apomera/AlloFlow/blob/HEAD/AdminBrief.md) | | โ™ฟ Interim Accessibility Conformance Report (VPATยฎ 2.5Rev WCAG) | [VPAT-2.5-WCAG-AlloFlow.md](https://github.com/Apomera/AlloFlow/blob/HEAD/VPAT-2.5-WCAG-AlloFlow.md) | | โ™ฟ Current WCAG 2.2 audit | [a11y-audit/WCAG-2.2-current-audit.md](https://github.com/Apomera/AlloFlow/blob/HEAD/a11y-audit/WCAG-2.2-current-audit.md) | | โ™ฟ Historical WCAG AA audit | [alloflow_wcag_aa_audit_report.md](https://github.com/Apomera/AlloFlow/blob/HEAD/alloflow_wcag_aa_audit_report.md) | | ๐Ÿ“– Complete User Manual | [AlloFlow Complete User Manual.md](https://github.com/Apomera/AlloFlow/blob/HEAD/AlloFlow%20Complete%20User%20Manual.md) | | Teacher Guide (searchable) | [guide/index.html](https://github.com/Apomera/AlloFlow/blob/HEAD/guide/index.html) | | Teacher Guide (offline / print) | [guide/offline.html](https://github.com/Apomera/AlloFlow/blob/HEAD/guide/offline.html) | | ๐Ÿ–จ๏ธ Quick Reference Cards | [QuickReferenceCards.md](https://github.com/Apomera/AlloFlow/blob/HEAD/QuickReferenceCards.md) | | ๐Ÿ—๏ธ Architecture Overview | [architecture.md](https://github.com/Apomera/AlloFlow/blob/HEAD/architecture.md) | | ๐Ÿš€ Firebase Deployment | [DEPLOY_YOUR_OWN.md](https://github.com/Apomera/AlloFlow/blob/HEAD/DEPLOY_YOUR_OWN.md) | | ๐Ÿ”’ Security Policy | [SECURITY.md](https://github.com/Apomera/AlloFlow/blob/HEAD/SECURITY.md) | | ๐Ÿค Contributing | [CONTRIBUTING.md](https://github.com/Apomera/AlloFlow/blob/HEAD/CONTRIBUTING.md) | | ๐Ÿ› Report Issues | [GitHub Issues](https://github.com/Apomera/AlloFlow/issues) | --- ## ๐Ÿ”ง For Developers AlloFlow uses a **Hub-and-Spoke architecture** โ€” a single orchestrator component (`App.jsx` / `AlloFlowANTI.txt`, ~31K lines in the current deploy copy) dynamically loads a large set of modules and plugin families on demand: STEM Lab (144 plugin files / 145 registered IDs), SEL Hub (71 tools), BehaviorLens, Report Writer, Symbol Studio, Word Sounds, Student Analytics, StoryForge, Cinematic Studio (docโ†’video), AlloStudio, Open Groove Studio, Professional Development, Doc Pipeline, Games, AI Backend, and more. Modules are served from the selected deployment's static asset host; `build.js` handles URL resolution. See [CONTRIBUTING.md](https://github.com/Apomera/AlloFlow/blob/HEAD/CONTRIBUTING.md) for architecture rules and [architecture.md](https://github.com/Apomera/AlloFlow/blob/HEAD/architecture.md) for a full technical overview. ```bash # Cloud deployment (Firebase) cd desktop/web-app npm install npm run build firebase deploy # Desktop local runtime npm.cmd run desktop:check npm.cmd run desktop:smoke npm.cmd run desktop # Run clinical logic test suite (no dependencies) node tests/clinical_tests.js ``` ### ๐Ÿงช Test Suite AlloFlow includes **117 automated tests** covering clinical decision-making logic โ€” the scoring algorithms, classification lookups, and data transformations that affect real student services. Tests are organized in three tiers: - **Tier 1 (Clinical Decisions):** Score classification (standard + T-score), percentile calculation, PII scrubbing, RTI tier classification, developmental norms - **Tier 2 (Learning Tracking):** Familiarity scoring, word growth levels, codename validation, Pearson correlation, aimline monitoring - **Tier 3 (Data Quality):** Math fluency benchmarks, error analysis, doc pipeline issue normalization, assessment preset integrity Run with `node tests/clinical_tests.js` โ€” zero dependencies, just Node.js. See [tests/README.md](https://github.com/Apomera/AlloFlow/blob/HEAD/tests/README.md) for full documentation. --- ## ๐Ÿค Contributing Contributions are welcome โ€” especially new STEM/SEL tools, accessibility improvements, clinical test cases, and additional language support. 1. Read [CONTRIBUTING.md](https://github.com/Apomera/AlloFlow/blob/HEAD/CONTRIBUTING.md) for architecture rules (Hub-and-Spoke pattern, Cloudflare CDN module resolution, plugin templates). 2. Read [architecture.md](https://github.com/Apomera/AlloFlow/blob/HEAD/architecture.md) for a full technical overview. 3. Open a descriptive PR explaining which UDL checkpoint or clinical workflow your change enhances. **Quick wins for new contributors:** - Add a new STEM tool (`stem_lab/stem_tool_yourname.js`) โ€” self-contained, no core file changes needed - Add a new SEL tool (`sel_hub/sel_tool_yourname.js`) โ€” same plugin pattern - Add clinical test cases to `tests/clinical_tests.js` (verify expected values against assessment manuals) - Improve i18n strings in `ui_strings.js` for an underrepresented language - Add keyboard navigation to an existing game - Fix an issue tagged `good first issue` on [GitHub Issues](https://github.com/Apomera/AlloFlow/issues) --- ## ๐Ÿ“„ License & Credits **AGPL v3** โ€” free and open source under a strong copyleft license, supporting educational technology as a public good. ยฉ 2026 Aaron Pomeranz, PsyD

Built by a school psychologist, for educators.
"Differentiation should be the default, not the exception."