Skip to content

README.md

Latest commit

 

History

History
124 lines (93 loc) · 3.51 KB

README.md

File metadata and controls

124 lines (93 loc) · 3.51 KB
Raw

Innerscape

Personal growth OS — self-awareness, productivity, and well-being in one unified TypeScript suite.

Stack

Layer Tech
Backend Fastify 5, Prisma 6, PostgreSQL, JWT (jose), Zod
Mobile Expo SDK 53, React Native, TanStack Query v5, Expo Router
Shared TypeScript types across backend + mobile
Deploy Docker Compose, Traefik, Let's Encrypt TLS

Quick Start

Prerequisites

  • Node.js 22+
  • PostgreSQL 16+
  • Expo CLI

Backend

cd apps/backend
cp .env.example .env    # Edit with your DB connection
# Generate a local JWT secret: openssl rand -base64 32
npm ci
npx prisma migrate dev
npm run dev

For Docker Compose deployments, set POSTGRES_PASSWORD and JWT_SECRET in the deployment environment before starting the stack; the compose file intentionally refuses to boot with placeholder production secrets.

Mobile

cd apps/mobile
npm ci
npx expo start

Run Tests

cd apps/backend
npm test                # 143 integration tests
npx tsc --noEmit        # Zero errors

Agent Surfaces

Innerscape exposes three local agent surfaces for project and reflective workflow support:

  • CLI: npm run cli -- brief, npm run cli -- modules, or npm run cli -- plan --focus "weekly review" --energy low.
  • MCP: npm run mcp starts a stdio MCP server with tools for the project brief, module map, and bounded planning prompts.
  • Skill: skills/innerscape/SKILL.md tells compatible agents how to use Innerscape without overstepping into diagnosis or major life automation.

Example MCP config from an installed checkout:

{
  "mcpServers": {
    "innerscape": {
      "command": "npm",
      "args": ["run", "mcp", "--prefix", "/path/to/Innerscape"]
    }
  }
}

Repository Structure

apps/
  backend/          Fastify API — 72 endpoints
    src/
      routes/       auth, emotional, journal, flow, body, hub, declutter, trade
      services/     auth, insights, vision-analysis
      middleware/    JWT auth
    tests/
      integration/  9 test files, 143 tests
  mobile/           Expo app — 5 tabs (Home, Mind, Flow, Body, Hub)
    hooks/          16 data hooks (TanStack Query)
    components/     12 UI components
packages/
  shared/           Shared TypeScript types

Modules

Tab Features
Mind Journal entries, emotional check-ins, AI insights
Flow Habits (streaks), goals, tasks, dopamine menu
Body Sleep logs, somatic mapping, space scanning
Hub Capture inbox, projects (PARA), knowledge base, reviews, trade marketplace

API

  • Auth: register, login, user preferences
  • Emotional: check-ins, context tracking
  • Journal: CRUD entries, insights CRUD, insight generation
  • Flow: habits, goals, tasks, dopamine menu
  • Body: sleep logs, somatic mappings, space scanning
  • Hub: capture, projects, knowledge, daily/weekly reviews
  • Trade: listings, matches, credits, rules
  • Declutter: sessions, items, valuations, decisions

License

MIT — KyaniteLabs

Part of KyaniteLabs

More from KyaniteLabs. Related projects:

  • Elixis — local-first AI pattern-synthesis engine for ideas
  • openglaze — free ceramic glaze calculator (UMF)
  • liminal — AI creative-coding studio (p5.js, GLSL, Three.js)

→ More at kyanitelabs.tech