Guided practice · Next.js

Guided practice — Next.js

This implementation is available in the repository. Fork it, run locally, and adapt the host UI around the same Experience speak / listen APIs.

Run locally

From the repo root, ./start runs all examples (or ./start sveltekit / ./start nextjs / ./start react-vite for those frameworks). To run only this one:

cd examples/guided-practice/nextjs
npm install
npm run dev
# http://localhost:4004

Local URL: http://localhost:4004

Liforma integration

Mount <Experience /> from @liforma/client/react:

<script src="https://cdn.liforma.ai/sdk/v2/client.js"><\/script>

<!-- experience-id comes from the selected lesson / session config -->
<liforma-experience experience-id="${lesson.experienceId}"></liforma-experience>

Key files

• PracticeApp.tsx / workspace component — host UI and Experience APIs
• lib/ — turns / feedback helpers when present

Related docs

• Embed an Experience
• Web Component reference
• Experience on Meet — hosted experience without the lesson app UI

Use the Liforma Guided practice Next.js App Router example as source material.

Source repo folder: examples/guided-practice/nextjs

Preserve:
- React `Experience` / speak API usage shown in the example
- `'use client'` on the Experience mount component
- import from `@liforma/client/react` (not `/next` — that export is the session-route helper)
- TypeScript and normal CSS (no Tailwind)

Adapt:
- branding
- host UI / turns
- experience id