Open Identity Context Infrastructure for the AI Era. Stop reintroducing yourself to every AI.

Quick Start • Architecture • Tech Stack • Docs • Live Demo →

---

The AI era needs a new identity layer. Every time you use a new AI assistant, you re-explain who you are. OasisBio fixes this — create your structured identity once, let machines understand you everywhere.

---

✨ What is OasisBio?

OasisBio is an open identity context infrastructure for the AI era.

Build structured, machine-readable identity profiles that AI assistants and applications can instantly understand. Stop reintroducing yourself to every AI — create your context once, use it everywhere.

Core Modules

Module	What it does
🧬 Identity Context	Structured profiles with AI-readable data format
🔗 Context API	REST endpoint GET /api/context/:slug for machine access
🔐 OAuth Provider	"Continue with Oasis" — OAuth 2.0 + PKCE + OIDC with context:read scope
⚡ Ability Pool	Machine-consumable skill profiles with proficiency levels
📜 DCOS Repository	Core operating scripts that define your decision-making framework
🔍 References Library	External knowledge that shapes your identity context
🌍 World Context	Environments and settings that influence your identity
🧠 Nuwa AI	Cognitive framework distillation for AI understanding
🏷️ Tag System	Polymorphic tags across entities for categorization
👥 Relationships	Connections between identities for network context

Identity Context Features

Feature	Description
Machine-Readable	Structured JSON format that AI can parse instantly
Portable	Use via REST API, OAuth, or .well-known endpoint
Privacy-Controlled	Fine-grained permissions, you decide what each app reads
OAuth-Enabled	Standard OAuth 2.0 integration for third-party apps
Version-Tracked	Evolution of identity over time

---

🏗️ Architecture

┌──────────────────────────────────────────────────────────────┐
│                    Next.js 16 (App Router)                   │
│  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│  │ SSR+RSC │ │ API Routes│ │ Middleware│ │ OAuth Provider   │ │
│  └────┬────┘ └────┬─────┘ └────┬─────┘ └──────┬───────────┘ │
│       │          │           │              │               │
│  ┌────▼──────────▼───────────▼──────────────▼─────────────┐ │
│  │            Prisma 6 ORM (PostgreSQL via Supabase)        │ │
│  │              23 models · RLS · RPC functions             │ │
│  └────────────────────────┬────────────────────────────────┘ │
│                           │                                    │
│  ┌────────────────────────▼────────────────────────────────┐ │
│  │  Supabase Auth (OTP) · Storage (images) · Edge Functions │ │
│  └────────────────────────┬────────────────────────────────┘ │
│                           │                                    │
│                    Cloudflare R2 (3D models · exports)         │
└──────────────────────────────────────────────────────────────┘

By The Numbers

Metric	Value
Source Code	~71K lines across 222 files
API Endpoints	53 REST routes
Database Models	23 Prisma models
Test Suites	Jest + fast-check property-based testing
Commits	305+ commits of iterative development
License	MIT

---

🛠️ Tech Stack

Layer	Technology	Version
Framework	Next.js (App Router)	16.2
Language	TypeScript	5.4 (strict)
Styling	Tailwind CSS	3.4 (OKLCH color space)
Database	PostgreSQL via Supabase	—
ORM	Prisma	6.19
Auth	Supabase Auth (OTP/passwordless)	—
AI Pipeline	OpenAI-compatible LLM	—
3D Rendering	Three.js (GLTFLoader)	0.183
Testing	Jest + fast-check	latest
Deployment	Vercel	—

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• A Supabase project (free tier works)
• A Cloudflare account with R2 enabled (for 3D models)

# Clone the repository
git clone https://github.com/zbbsdsb/oasisbio.git
cd oasisbio && npm install

# Configure environment
cp .env.example .env

# Push schema & generate Prisma client
npx prisma db push && npx prisma generate

# Run database setup scripts in Supabase SQL Editor (in order):
#   scripts/db/01_enable_rls.sql
#   scripts/db/02_add_indexes.sql
#   scripts/db/04_storage_policies.sql
#   scripts/db/05_domain_events_audit_logs.sql
#   scripts/db/06_publish_bio_rpc.sql
#   scripts/db/07_oauth_tables.sql

# Start development server
npm run dev

Open http://localhost:3000.

---

📁 Project Structure

oasisbio/
├── src/
│   ├── app/
│   │   ├── api/                  # 53 REST endpoints
│   │   │   ├── oauth/            # OAuth 2.0 + OIDC (authorize/token/userinfo/JWKS)
│   │   │   ├── nuwa/             # AI distillation pipeline (5 endpoints)
│   │   │   └── ...               # bios, worlds, abilities, dcos, refs, etc.
│   │   ├── dashboard/oasisbios/[id]/  # Character editor (8 sub-tabs)
│   │   │   ├── page.tsx          # Identity editor
│   │   │   ├── eras/page.tsx     # Era timeline
│   │   │   ├── abilities/page.tsx # Ability pool
│   │   │   ├── worlds/           # World builder (list + wizard + detail)
│   │   │   ├── dcos/page.tsx    # DCOS documents
│   │   │   ├── references/page.tsx # References library
│   │   │   ├── relationships/page.tsx # Character relationships
│   │   │   └── nuwa/page.tsx     # AI workspace (685 lines)
│   │   ├── bio/[slug]/page.tsx   # Public profile (SEO-optimized)
│   │   ├── developer/            # OAuth developer portal
│   │   └── page.tsx             # Landing page (7-section Swiss grid design)
│   ├── components/
│   │   ├── world/                # World builder UI (StepWizard, ModuleSection)
│   │   ├── auth/                 # Login/register forms
│   │   └── Tooltip.tsx           # Accessible guidance system (22 test cases)
│   ├── lib/
│   │   ├── nuwa/                 # AI distillation core (5 modules)
│   │   │   ├── types.ts          # Type contracts (~25 interfaces)
│   │   │   ├── source-snapshot.ts # Snapshot builder + hash
│   │   │   ├── llm.ts            # OpenAI-compatible LLM client
│   │   │   ├── orchestrator.ts   # Pipeline coordinator
│   │   │   └── apply.ts          # Suggestion applier
│   │   ├── oauth/                # OAuth provider (crypto/middleware/scopes)
│   │   ├── supabase/            # SSR/browser/middleware clients
│   │   └── storage.ts           # Unified Supabase + R2 storage layer
│   └── services/                # Import/Export service (ZIP)
├── prisma/schema.prisma         # 23 models, RLS enabled
├── scripts/db/                   # 7 SQL setup scripts
├── docs/
│   ├── technical.md             # Full architecture reference (2000+ lines)
│   ├── nuwa-integration.md      # AI pipeline docs (620 lines)
│   ├── design.md                # Design system (Swiss grid, OKLCH palette)
│   ├── OasisBio Strategic Plan.md # Product roadmap (English)
│   └── features/                # Feature specs (oauth, worlds, abilities...)
├── public/assets/                # Logo, sample images, 3D models
├── OasisBio Manifesto.md        # Vision statement
└── LICENSE                       # MIT

---

🧪 Testing

npm test                  # Jest unit + property tests
npm run test:watch        # Watch mode
npm run test:coverage     # Coverage report

Area	Tests	Status
User sync (property-based)	4 properties	✅ Passing
Route protection (property-based)	1 property	✅ Passing
Auth state machine (property-based)	1 property	✅ Passing
OAuth crypto / validate / middleware	16 test files	✅ Passing
Tooltip component	22 test cases	✅ Passing
Nuwa Integration	—	🔲 Pending (Phase 4)

---

📖 Documentation

Document	Description
Technical Reference	Architecture, auth flow, DB schema, all API endpoints, OAuth provider, testing, deployment
Nuwa AI Integration	AI distillation architecture, data model, 5 API endpoints, caching strategy, roadmap
Strategic Plan	Product roadmap: Phase 1–4, core mission, what we won't do
Design System	Swiss grid, OKLCH color space, typography, component specs, accessibility
World Design Spec	6-module worldbuilding standard with field definitions
OAuth Developer Guide	"Continue with Oasis" integration guide + React example
Manifesto	Vision: digital immortality, cross-generational identity protocol

---

🤝 Contributing

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Make changes with clear commit messages
4. Run npm run lint and npm test to validate
5. Push to your fork and open a Pull Request

Development Workflow

• This project uses TypeScript strict mode — all code must pass type checking
• Follow the existing code style (ESLint config included)
• New features should include tests where practical (Jest + fast-check)
• For database schema changes, update both schema.prisma and relevant SQL setup scripts

Code Quality Checklist

• TypeScript compiles without errors (npx tsc --noEmit)
• ESLint passes (npm run lint)
• Tests pass (npm test)
• New API routes use requireAuth() and proper error handling
• New frontend components follow existing patterns (Tailwind, lucide-react icons)

---

📄 License

MIT © 2026 ceaserzhao (Oasis Company)

See LICENSE for details.

---

Built with care by Oasis Company.

Open identity context infrastructure for the AI era. 🌊

Report Bug · Request Feature · Live Demo