Lobyas

A private, invite-only app for learning the terms of a field or the words and phrases of a language well enough to actually use them, not just recognize them. A collection is either field terms (a new job's jargon, a technical area) or a language's vocabulary, including phrases and grammar. Import lists into collections (or start with built-in ones), read, review a ranked queue when you feel like it, and quiz when you want a check-in. No due dates — there's an optional streak badge, but nothing punishes you for breaking it.

AI is optional and works only from your own terms: Stories written around the terms you're due to read (a style and setting for any collection, plus an A1–C2 level for a language), AI quizzes, and spoken audio for terms and stories. Simple quizzes, Read and Review never use credits. Typed-recall quiz questions are for vocabulary collections.

Terms go beyond one-line definitions: optional example, mental model, in-practice notes, anti-example, debated angles, a freeform note, and links to related terms. Known/unknown isn't set by hand — it's read off how well you've actually retained a term, and fades again if you stop practicing it.

The same TRACE ranking powers Read, Review, and Quiz across every surface — not random shuffle, and not spaced repetition with future review dates. Collection browse picks its own way and doesn't use the ranking.

See the landing page for how to request an invitation.

Documentation

• TRACE scoring engine — scoring, outcomes, and how picking works across surfaces
• Narration sync cron — Dashboard job that continues admin audio generation after the first invoke
• User-facing guide at /how-terms-work (term structure, how known/unknown status is computed) when the app is running — linked from the landing page and site footer

Prerequisites

• Node.js 24
• pnpm
• Supabase CLI for local database and auth

Local development

1. Install dependencies:

   pnpm install
   

2. Copy environment variables:

   cp .env-template .env.local
   

3. Start Supabase locally and fill .env.local from the CLI output:

   pnpm supabase:start
   pnpm supabase:status
   

4. Apply migrations (resets local data):

   pnpm supabase:reset
   

5. Run the dev server:

   pnpm dev
   

   Open http://localhost:3000.

Regenerate TypeScript types after schema changes:

pnpm supabase:types

Scripts

Command	Purpose
pnpm dev	Start Next.js in development
pnpm build	Build the production app
pnpm check	Lint, format check, type-check, and unused-code check (knip)
pnpm supabase:start / stop / status	Local Supabase lifecycle
pnpm supabase:reset	Reset local DB and run migrations

Tech stack

Next.js 16, React 19, Supabase (Postgres + Auth), Tailwind CSS 4, DaisyUI, TypeScript.

Project layout

Path	Role
app/	Next.js routes (auth, app UI, API)
components/	React UI
lib/trace/	TRACE scoring — decay, recall, mastery
lib/trace-queue/	Term-picking pipeline built on TRACE
lib/terms/	Term model, cards, outcomes, term CRUD
lib/library/	Library page data, collections, filters
lib/study/	Collection scope and study pool wrapper
supabase/	Migrations and SQL tests
docs/	Internal documentation