Interactive webapp teaching the 7 Hermetic Principles through beautiful experiences. Sacred technology built with Gold Hat philosophy - empowerment, not extraction.
Interactive webapp teaching the 7 Hermetic Principles to youth (ages 11-18)
Transform the ancient wisdom of the 7 Hermetic Principles into interactive, engaging experiences that speak to modern youth. No lectures, no preaching - just exploration, discovery, and empowerment.
- Mentalism - Your thoughts shape your reality
- Correspondence - Patterns repeat at all scales
- Vibration - Everything moves, everything vibrates
- Polarity - See both sides, find balance
- Rhythm - Life has seasons, honor the cycles
- Cause & Effect - Your choices matter
- Gender - Balance masculine and feminine energies
- Mentalism: Mind map builder showing cascading thought effects
- Correspondence: Fractal zoom explorer revealing patterns
- Vibration: Sound frequency visualizer
- Polarity: Perspective flip game
- Rhythm: Natural cycle tracker
- Cause-Effect: Chain reaction simulator
- Gender: Balance visualizer
- Public reflection sharing (anonymous option)
- Wisdom reactions (not likes)
- Safe, moderated space
- Optional theme customization
- Achievement badges
- Avatar options
- All content free forever - cosmetics support development
- Frontend: Next.js 14 (App Router) + TypeScript + Tailwind CSS
- Backend: Supabase (PostgreSQL + Auth + Edge Functions)
- Animations: Framer Motion
- UI Components: Radix UI
- Deployment: Vercel (frontend) + Supabase (backend)
This project embodies sacred technology principles:
We Build: ✅ Empowering educational experiences ✅ Anonymous safe spaces ✅ Optional community (never forced) ✅ Privacy-respecting systems ✅ Open source (MIT license)
We Reject: ❌ Dark patterns ❌ Infinite scroll ❌ Engagement optimization over wellbeing ❌ Paywalled wisdom ❌ Data extraction
The Question: "Does this empower or extract?"
- Node.js 18.17+
- npm or yarn
- Supabase account (free tier works)
# Clone the repository
git clone https://github.com/HermeticOrmus/hermetic-academy.git
cd hermetic-academy
# Install dependencies
npm install
# Set up environment variables
cp .env.local.example .env.local
# Edit .env.local with your Supabase credentials
# Run development server
npm run devOpen http://localhost:3000 to see the app.
See DATABASE.md for complete Supabase configuration.
hermetic-academy/
├── app/ # Next.js app directory
│ ├── layout.tsx # Root layout
│ ├── page.tsx # Homepage
│ ├── principles/ # Principle pages
│ ├── community/ # Community features
│ └── profile/ # User profiles
├── components/ # React components
│ ├── experiences/ # Interactive principle experiences
│ ├── ui/ # Reusable UI components
│ └── layout/ # Navigation, footer
├── lib/ # Utilities
│ ├── supabase.ts # Supabase client
│ ├── constants.ts # Principle data
│ └── utils.ts # Helper functions
├── public/ # Static assets
└── supabase/ # Database migrations
Every decision follows the 7 Principles:
- Mentalism: Clear intent documented in code
- Correspondence: Architecture mirrors values
- Vibration: Rapid iteration, continuous improvement
- Polarity: Balance sophistication with simplicity
- Rhythm: Sustainable 6-day dev cycles
- Cause-Effect: Every choice serves empowerment
- Gender: Technical precision + aesthetic beauty
- Timeless cool (not trendy)
- Respect intelligence (never condescending)
- Mobile-first (they live on phones)
- Accessible (WCAG AA minimum)
- Safe (moderated, anonymous options)
We welcome contributions that align with our Gold Hat philosophy!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-idea) - Commit your changes (
git commit -m 'Add amazing idea') - Push to the branch (
git push origin feature/amazing-idea) - Open a Pull Request
- All wisdom content remains free
- No dark patterns or manipulative UX
- Maintain accessibility standards
- Test on mobile devices
- Document your code (explain WHY)
See CONTRIBUTING.md for details.
MIT License - see LICENSE for details.
Open source from Day 1 - learn from our code, fork it, improve it, teach others.
- Project foundation
- All 7 interactive experiences
- Basic community features
- Cosmetic system
- Deploy to production
- Mobile apps (React Native)
- Educator tools (classroom mode)
- Multi-language support
- Advanced analytics (ethical)
- Peer mentor system
Project: Hermetic Academy Philosophy: Gold Hat Technology Status: Autonomous execution by Sol (Phase 1)
For questions or collaboration: Open an issue
Built with the 7 Hermetic Principles as our guide. Every line of code serves empowerment.
"As above, so below. As the code, so the consciousness."
Last Updated: 2025-11-09 (Day 1 - Foundation)
This repository is part of a growing family of open-source toolkits for Claude Code.
- LibreUIUX-Claude-Code — UI/UX development (152 agents, 70 plugins, 76 commands, 74 skills)
- LibreArch-Claude-Code — Software architecture and system design
- LibreCopy-Claude-Code — Technical writing and documentation engineering
- LibreDevOps-Claude-Code — DevOps engineering and infrastructure automation
- LibreEmbed-Claude-Code — Embedded systems, firmware, and IoT development
- LibreFinTech-Claude-Code — Financial technology development
- LibreGEO-Claude-Code — AI-search optimization (ChatGPT, Perplexity, Gemini, Google AI Overviews)
- LibreGameDev-Claude-Code — Game development across Godot, Unity, Unreal
- LibreMLOps-Claude-Code — ML engineering and AI operations
- LibreMobileDev-Claude-Code — Mobile app development (Flutter, React Native, native iOS, native Android)
- LibreSecOps-Claude-Code — Security operations
- vibe-engineer-skills — Direct AI codegen well (hypothesis → scope → validate → reject working-but-wrong)
- markdown-discipline-skills — Strip AI-slop from markdown (no em dashes, no marketing fluff)
- shell-safety-skills —
set -euo pipefaildiscipline + 15 failure-mode examples - commit-standard-skills — Ormus Commit Standard v1.0 + commit-msg hook + commitlint
- unwoke-skills — Strip AI theater (ten sins to eliminate, symmetric engagement)
- python-conventions-skills — Modern Python 3.11+ (types, pathlib, async, ruff, mypy, uv)
- typescript-conventions-skills — TypeScript strict mode, discriminated unions, Result types
- hermetic-laws-skills — Seven Hermetic Principles applied to engineering
- riper-workflow-skills — Research / Innovate / Plan / Execute / Review systematic dev
- six-day-cycle-skills — Sustainable shipping cadence with mandatory rest
- token-optimization-skills — Claude Code token + context optimization
- osint-skills — OSINT research methodology (multi-wave investigative spiral)
- calcinate-skills — Stage 1 of the Magnum Opus (burn project bloat)
- claude-md-overhaul-skills — Audit CLAUDE.md and MEMORY.md against caps
- session-handoff-skills — Session handoff + pickup discipline
- naming-skills — Product naming methodology (mine the brand's vocabulary)
- magnum-opus-skills — Seven-stage alchemy applied to project transformation
- andrej-karpathy-skills — the canonical single-file CLAUDE.md pattern (fork of jiayuan_jy's original)
Star the family, not just one — that's how the suite stays coherent.