Planeree — Library prototype

A clickable prototype of the Planeree LMS Library for independent language teachers. It validates navigation, the learner context switch, and lesson personalization: one shared library, and an independent version of a lesson for each learner who uses it.

The interface is in Russian; code and docs are in English. There is no backend — all data lives in the browser's localStorage.

• Design: Planeree UI kit v1.4 (light theme) and brand guidelines
• Stack: Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4, Zustand, Vitest

Run it

npm install
npm run dev      # http://localhost:3000
npm test         # domain rules and helpers
npm run lint
npm run build

Requires Node 20.9+ (developed on Node 24).

This Next.js version differs from older ones. Before changing framework-level code, read the bundled docs in node_modules/next/dist/docs/ (see AGENTS.md).

The core rule

Every lesson has a global version in the library. A learner gets their own version only when the teacher does one of three things with that learner:

1. starts the lesson (startLesson),
2. adapts it (updateLearnerLessonContent),
3. assigns homework from it (assignHomework).

Browsing never creates one (resolveLesson is read-only). Once created, a learner's version is independent: later global edits don't reach it, and there is no sync or reset. The UI never says "copy" — it says «Общий материал» and «Версия для Анны».

A learner's textbooks

In a learner context, textbooks used with the learner come first in the library, most recently used first. Their cards and the textbook page show progress — finished lessons out of all — and the next lesson: the first untouched one after the furthest lesson taught (textbookProgress). Lessons skipped earlier are not suggested. With no lesson in progress, that next lesson takes the current-lesson slot with «Начать урок».

The catalog

«Каталог» lists Planeree's textbooks, the same for every teacher. «Добавить в библиотеку» gives the teacher an independent copy at the library root (addTextbookFromCatalog): the author stays, and later catalog changes never reach it. The catalog ignores the learner context; a teacher who came from a learner gets ?from= — breadcrumbs back and «Открыть для Анны» — and nothing else changes. Materials by someone else show their author; the library's «Источник» filter appears once there are any.

Deleting a textbook, section or lesson is blocked (with an explanation) when it would lose learner history. Deleting a folder never deletes materials: its contents move to the library root.

Where things are

src/lib/
  types.ts        Data model (spec §13) + `adapted` flag on blocks
  domain.ts       All product rules as pure functions (AppData in → AppData out)
  meta.ts         Textbook metadata: subject, age group, level options and library filters
  domain.test.ts  Acceptance scenarios 3–7, deletion rules, demo data integrity
  store.ts        Zustand store persisted to localStorage; thin wrapper over domain.ts
  demo-data.ts    Learners, folders, textbooks, lessons and histories (spec §14)
  catalog.ts      The public catalog: Planeree's textbooks, read-only and not persisted
  context.ts      Learner context from `?learner=` and link helper
  learners.ts     Initials, labels, genitive names («для Анны»)
  format.ts       Russian plurals and dates
src/components/
  ui/             UI kit primitives: Button, Menu, Dialog, Badge, SegmentedControl, …
  library/        The one Library component, shared by global and learner contexts
  catalog/        Catalog grid, read-only textbook and lesson previews, «Добавить в библиотеку»
  textbook/       Textbook: creation form, editable header (cover, metadata), flat or sectioned structure
  learner/        Learner workspace: current lesson, lesson history chips with homework marks
  lesson/         Lesson placeholder: blocks, editor, homework dialog
  live/           Placeholder for the live lesson (another product area)
src/app/          Routes: /library, /textbook/[id], /lesson/[id], /live

Context is part of the URL — /library?learner=anna, /lesson/les_present_simple?learner=anna — so refresh and links keep it. No learner means the global library.

Demo walkthrough

Scenario	Try this
Global content	«Библиотека» → the «+» tiles at the start of Папки and Материалы, ⋯ menus; open a textbook to manage sections
Textbooks	«Добавить материал» → fill the form → the new textbook opens ready to edit. Switch «Использовать разделы» before adding lessons; drag sections and lessons by their handles (or focus a handle and press ↑ ↓)
Filters	Предмет · Возрастная группа · Уровень under the search, in the library and in student and group pages. They search every folder; lessons inside textbooks use the textbook's metadata
Learner navigation	Switch Библиотека → Анна → Максим in the top strip
Personalized lesson	Анна → English File Elementary → Present Simple → «Адаптировать урок» → add an exercise → save. Open the same lesson for Максим: it isn't there
Global edits don't propagate	Библиотека → Present Simple → «Редактировать» → change a block. Анна keeps hers; Максим sees the change
History	София → any lesson → «Начать индивидуальный урок» → «Завершить урок» → it appears as a chip in «История уроков»
Live lesson (not built)	Анна → «Продолжить урок» opens a «пока строится» page; live lessons belong to another product area
Homework	Максим → lesson → «Назначить домашку»; the lesson's chip gets a homework mark. Change status from the badge in the lesson header
Student profile	Click a student's name (e.g. Паша, with a picture avatar) → profile panel: email, schedule, balance, notes
Groups	Группа B1 → its students → Ксения: «Индивидуально» is her page's context, «Группа B1» leads back to the group («Начать урок с группой»)

Reset demo data: run localStorage.removeItem("planeree-library") in the browser console and reload. Changing the data shape? Bump STORAGE_VERSION in store.ts; older saved data is then replaced by fresh demo data.

Deploy

Vercel detects Next.js automatically; no extra configuration is needed. Import the Git repository at vercel.com/new and keep the defaults (build npm run build). The / → /library redirect lives in next.config.ts.