FringeIsland
Version: 0.2.37 | Updated: April 2026 | Wave 1 (Ferd): 95% complete
An edutainment platform for group-based personal development through structured learning journeys. Users travel solo or in groups on predefined journeys guided by role-based experiences — per-group roles: Stewards lead, Guides facilitate, Participants take part, and Observers watch. Identity runs Mist → FIM; Dreamineer is the permission-gated authorial mode (Creator, Anthropologist, Teller, Wayfinder); enterprise stewardship sits with the Universeers, the FringeIsland Council, and DeusEx. See the the Universe Bible's roles and governance chapter.
FringeIsland is one lived experience over a shared core, where people can Live, Grow, and Matter. Products are equipment profiles of that experience — The Hub (the canvas surface, web) and The Gimbal (the senses surface, mobile); the Game is a depth setting of journeys, not a product (ADR-U025). Authoring happens in studios under Universe Studio as parent — World, Arc, and Journey Studios (ADR-U026). See VISION.md for the full vision.
Tech Stack
- Framework: Next.js 16.1 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS
- Backend: Supabase (PostgreSQL, Auth, Storage, Realtime)
- Database: 19 tables with RLS on every table
- Testing: Jest (659 tests: integration + unit) + Playwright (7 E2E tests)
- Methodology: Test-Driven Development (TDD) — behaviors first, then failing tests, then implementation
Security
- Row Level Security (RLS) on all 19 tables — users can only access data they're authorized for
- Supabase Auth with email/password and session management
- Protected routes via
proxy.ts (Next.js 16 pattern, not middleware)
- RBAC — 4 per-group roles (Steward, Guide, Participant — still named
Member in the current schema — Observer), 31 permissions, has_permission() SQL function
- Admin isolation —
is_platform_admin() SECURITY DEFINER function for admin-level RLS checks
Getting Started
Prerequisites
- Node.js 18+
- npm or yarn
- Supabase account
Installation
- Clone the repository
npm install- Create
.env.local with Supabase credentials
- Apply database migrations
npm run dev- Open
http://localhost:3000
Testing
npm run test:integration:auth # Auth tests
npm run test:integration:groups # Group tests
npm run test:integration:journeys # Journey tests
npm run test:integration # Full suite (~8 min)
npm run test:integration:quick # Stops on first failure
npm run test:e2e # E2E (requires dev server)
Documentation
Start at docs/README.md for the full navigation map. Key entry points:
License
Proprietary - All rights reserved
Built with Next.js, TypeScript, and Supabase
