NewWorldEdu β Master Handoff Summary
---
π THE PLATFORM
**Name:** NewWorldEduβ
**URL:** Deployed on Vercel
**Local path:** `/Users/whitestar/newworld-platform/`
**Deploy command:** `cd /Users/whitestar/newworld-platform && npm run build && npx vercel --prod`
**Framework:** Next.js (pages directory)
**AI model used in all pages:** `claude-haiku-4-5-20251001` via `/api/chat`
**Branding:** NewWorldEduβ
Β· Dark navy theme (#060B20 β #0D1635) Β· Nunito font
**Contact:** hello@newworld.education
---
π ALL PAGES BUILT
| Page | Route | Description |
|------|-------|-------------|
| Homepage | `/` | Grade selector (KGβA-Level) + subject scroll + hero |
| Special Needs | `/special-needs` | Condition Γ Age Γ Focus 3-step matrix (140 profiles) |
| Music | `/music-for-all` | Age-calibrated music tutor + SEN profiles |
| Arts | `/arts-for-all` | Adaptive art tutor for 7 SEN profiles |
| Reading | `/reading-for-all` | AI reading tutor for 7 SEN profiles, 70+ books |
| Music (General) | `/music` | KGβGrade 12 music tutor, 8 instruments |
| Arts (General) | `/arts` | KGβGrade 12 art tutor, 4 studios |
| Reading (General) | `/reading` | KGβGrade 12 reading, 120+ books |
| Textbooks | `/textbooks` | Cambridge O/A Level chapter browser + AI |
| Past Papers | `/past-papers` | Exam paper practice |
| Pricing | `/pricing` | All plans + PayPal subscription integration |
| Disclaimer | `/disclaimer` | Full legal/safeguarding disclaimer (8 sections) |
| Parent Portal | `/parent` | Parent guidance |
| Start | `/start` | Post-payment onboarding |
| Demo | `/demo` | Demo session |
---
π° PRICING PLANS
| Plan | Price | PayPal Plan ID |
|------|-------|----------------|
| Starter | Free (5 sessions/day) | β |
| Academic Plus | $49.99/month | (in pricing.jsx) |
| Special Needs | $99.99/month | (in pricing.jsx) |
| **Creative Bundle** | **$79.99/month** | **P-60C25004ES421424TNGTU3JA** |
| Annual (all access) | varies | (in pricing.jsx) |
**Creative Bundle** includes: Music, Arts, Reading β unlimited sessions, all ages KGβA-Level, 7-day free trial, 1 child
Color: `#FF8C69` (coral) Β· Emoji: π¨
---
β COMPLETED β WHAT'S BEEN BUILT AND DEPLOYED
- β Homepage with grade selector scroll + subject navigation
- β Special Needs page β full condition Γ age Γ focus matrix (7 conditions Γ 4 stages Γ 5 focuses = 140 profiles)
- β SEN Knowledge Base (`utils/senKnowledge.js`) β 9-section evidence-based document drawn from PMC 2024-2025, IDA, DSEI, NICE, DSM-5, Cochrane Reviews
- β Music, Arts, Reading pages β each with age-stage selectors and SEN-adapted profiles
- β Music-for-all, Arts-for-all, Reading-for-all β full SEN specialist versions
- β Voice input (mic) + TTS output for young users (Rania, age 6, couldn't type fast enough β this was the trigger)
- β `useVoice.js` hook + `VoiceChatBar` component β strips emojis/markdown before speaking
- β `useSessionLimit.js` β session limit enforcement across all pages
- β StarkyBubble floating chat widget β appears on all pages, bottom-right
- β Mobile navigation menu β fixed multiple times; final working state has: Home, Special Needs, Parent Portal, Plans & Pricing, Past Papers, Textbooks, π¨ Arts, π΅ Music, π Reading
- β Pricing page β Creative Bundle added with PayPal integration
- β Pricing banners added to Music, Arts, Reading pages (above footer, gradient background, "View Plans β" CTA)
- β Disclaimer page (8 sections) β created as `disclaimer.jsx`
- β Footer disclaimer injection script β `add-disclaimer-footer.js`
---
β οΈ PENDING β ESSENTIAL BEFORE LAUNCH
These were explicitly identified as pre-launch requirements:
1. π΄ Disclaimer NOT yet deployed to footer
Step 2: Add disclaimer line to index.jsx footer
Step 3: Build and deploy
2. π΄ SEN Knowledge Base not integrated into special-needs.jsx
3. π΄ Price inconsistency on Special Needs page
4. π‘ PayPal subscription β end-to-end test
5. π‘ Mobile testing
6. π‘ Disclaimer link β add to ALL page footers
---
π LAUNCH CHECKLIST (in order)
1. β Fix price inconsistency ($149.99 β $79.99/month) on special-needs.jsx
2. β Confirm SEN knowledge base wired into special-needs.jsx
3. β Deploy disclaimer page + footer link
4. β Test PayPal subscription end-to-end
5. β Test /start page post-payment
6. β Test session limits (free vs paid)
7. β Mobile test: iPhone + Android
8. β Write launch posts (Instagram, LinkedIn, Facebook, Twitter/X)
9. β Write press release for EdTech media
10. β Write cold email for schools/tutoring centres
11. β Share in parent WhatsApp groups, school communities
12. β π LAUNCH
---
π KEY TECHNICAL NOTES
File Structure
Navigation Menu (Mobile) β Final Working State
AI API
Voice System
SEN Knowledge Base (`utils/senKnowledge.js`)
Special Needs Page β 3-Step Matrix
Disclaimer Page β 8 Sections
---
π― WHAT TO DO IN THE NEXT CHAT
Tell the new Claude:
> "I'm building NewWorldEdu, an AI tutoring platform. I have a master handoff document. My project is at `/Users/whitestar/newworld-platform/`. Before launching there are 6 pending tasks: [list from PENDING section above]. Please help me work through them in order."
Then paste this document or the PENDING section.
---
*Summary compiled: March 4, 2026 Β· All sessions: March 3, 2026*