Skip to content

feat: add interactive Learn section with embedded terminal#7

Open
lua-stefan-kruger wants to merge 1 commit intomainfrom
feat/learn-interactive-tutorials
Open

feat: add interactive Learn section with embedded terminal#7
lua-stefan-kruger wants to merge 1 commit intomainfrom
feat/learn-interactive-tutorials

Conversation

@lua-stefan-kruger
Copy link
Copy Markdown
Collaborator

@lua-stefan-kruger lua-stefan-kruger commented Mar 23, 2026

Summary

Adds a new Learn tab to the docs with an 18-lesson interactive curriculum. Each lesson embeds a StackBlitz WebContainer terminal where users can run real lua commands — no local setup required.

What's included

  • Learn tab added as the first tab in navigation
  • 18 lessons across 3 tracks: Beginner (6), Intermediate (7), Professional (5)
  • Lesson 1: Authentication fully built with:
    • Embedded StackBlitz terminal with lua-cli pre-installed
    • Step-by-step interactive instructions (lua auth configure, lua agents)
    • Knowledge check accordions
    • Navigation cards to next lesson
  • 17 placeholder lessons ready to be filled in

How the terminal works

  • Uses a pre-built StackBlitz project (ssyfrbnq) with lua-cli as a dependency
  • Each visitor gets an isolated browser sandbox (no shared state)
  • lua commands work directly (PATH configured to include node_modules/.bin)
  • Terminal embeds via iframe — no additional services to deploy

Preview

The Learn tab should appear as the first tab. Navigate to Learn > Authentication to see the embedded terminal.

Test plan

  • Verify Learn tab appears in navigation
  • Verify Authentication lesson renders with embedded terminal
  • Test lua --version in embedded terminal
  • Test lua auth configure interactive flow
  • Verify placeholder lessons render without errors

🤖 Generated with Claude Code


Note

Low Risk
Low risk docs-only change that adds navigation entries and new MDX pages; main risk is broken links/embedding issues from the external StackBlitz iframe.

Overview
Adds a new Learn tab to docs.json with three tracks (Beginner/Intermediate/Professional) and 18 lesson routes.

Introduces learn/authentication.mdx as the first lesson, including a StackBlitz terminal iframe plus step-by-step CLI auth/verification instructions, knowledge-check accordions, and next-step cards. The remaining 17 learn/*.mdx lessons are added as Coming Soon placeholders.

Written by Cursor Bugbot for commit 74dee5f. This will update automatically on new commits. Configure here.

Adds a new "Learn" tab to the docs with an 18-lesson curriculum
across 3 tracks (Beginner, Intermediate, Professional).

Each lesson includes an embedded StackBlitz WebContainer terminal
where users can run real lua-cli commands interactively — no local
setup required.

First lesson (Authentication) is fully built with:
- Embedded terminal with lua-cli pre-installed
- Step-by-step instructions
- Knowledge check questions
- Navigation to next lesson

Remaining 17 lessons are placeholders to be filled in.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix prepared a fix for the issue found in the latest run.

  • ✅ Fixed: All placeholder lessons show identical "Coming Soon" navigation titles
    • Updated all 17 placeholder lesson files to have unique titles following the pattern 'Lesson N: Topic Name' matching the existing authentication.mdx pattern, ensuring distinguishable sidebar navigation entries.

Create PR

Or push these changes by commenting:

@cursor push b881821387
Preview (b881821387)
diff --git a/learn/data-and-search.mdx b/learn/data-and-search.mdx
--- a/learn/data-and-search.mdx
+++ b/learn/data-and-search.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 8: Data and Search"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/dynamic-jobs.mdx b/learn/dynamic-jobs.mdx
--- a/learn/dynamic-jobs.mdx
+++ b/learn/dynamic-jobs.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 16: Dynamic Jobs"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/ecommerce.mdx b/learn/ecommerce.mdx
--- a/learn/ecommerce.mdx
+++ b/learn/ecommerce.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 13: E-commerce"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/full-project.mdx b/learn/full-project.mdx
--- a/learn/full-project.mdx
+++ b/learn/full-project.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 18: Full Project"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/integrations.mdx b/learn/integrations.mdx
--- a/learn/integrations.mdx
+++ b/learn/integrations.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 12: Integrations"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/mcp-servers.mdx b/learn/mcp-servers.mdx
--- a/learn/mcp-servers.mdx
+++ b/learn/mcp-servers.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 14: MCP Servers"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/multi-channel.mdx b/learn/multi-channel.mdx
--- a/learn/multi-channel.mdx
+++ b/learn/multi-channel.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 15: Multi-Channel"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/persona-design.mdx b/learn/persona-design.mdx
--- a/learn/persona-design.mdx
+++ b/learn/persona-design.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 6: Persona Design"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/processors.mdx b/learn/processors.mdx
--- a/learn/processors.mdx
+++ b/learn/processors.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 11: Processors"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/production-ops.mdx b/learn/production-ops.mdx
--- a/learn/production-ops.mdx
+++ b/learn/production-ops.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 17: Production Ops"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/push-and-deploy.mdx b/learn/push-and-deploy.mdx
--- a/learn/push-and-deploy.mdx
+++ b/learn/push-and-deploy.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 5: Push and Deploy"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/scheduled-jobs.mdx b/learn/scheduled-jobs.mdx
--- a/learn/scheduled-jobs.mdx
+++ b/learn/scheduled-jobs.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 10: Scheduled Jobs"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/skills-and-tools.mdx b/learn/skills-and-tools.mdx
--- a/learn/skills-and-tools.mdx
+++ b/learn/skills-and-tools.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 3: Skills and Tools"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/testing.mdx b/learn/testing.mdx
--- a/learn/testing.mdx
+++ b/learn/testing.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 4: Testing"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/user-state.mdx b/learn/user-state.mdx
--- a/learn/user-state.mdx
+++ b/learn/user-state.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 7: User State"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/webhooks.mdx b/learn/webhooks.mdx
--- a/learn/webhooks.mdx
+++ b/learn/webhooks.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 9: Webhooks"
 description: "This lesson is under development"
 ---
 

diff --git a/learn/your-first-agent.mdx b/learn/your-first-agent.mdx
--- a/learn/your-first-agent.mdx
+++ b/learn/your-first-agent.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Coming Soon"
+title: "Lesson 2: Your First Agent"
 description: "This lesson is under development"
 ---

This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.

@@ -0,0 +1,8 @@
---
title: "Coming Soon"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All placeholder lessons show identical "Coming Soon" navigation titles

High Severity

All 17 placeholder lesson files use title: "Coming Soon" in their frontmatter. In Mintlify, the title field is displayed in sidebar navigation and browser tabs. This means the Learn tab's sidebar will show 17 entries all labeled "Coming Soon" with no way to distinguish between them, making the navigation completely unusable. Each page needs a unique, descriptive title (e.g., "Your First Agent", "Skills and Tools").

Additional Locations (2)
Fix in Cursor Fix in Web

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant