diff --git a/docs.json b/docs.json
index 8783a85..c99bdde 100644
--- a/docs.json
+++ b/docs.json
@@ -14,6 +14,44 @@
"favicon": "/favicon.png",
"navigation": {
"tabs": [
+ {
+ "tab": "Learn",
+ "groups": [
+ {
+ "group": "Beginner",
+ "pages": [
+ "learn/authentication",
+ "learn/your-first-agent",
+ "learn/skills-and-tools",
+ "learn/testing",
+ "learn/push-and-deploy",
+ "learn/persona-design"
+ ]
+ },
+ {
+ "group": "Intermediate",
+ "pages": [
+ "learn/user-state",
+ "learn/data-and-search",
+ "learn/webhooks",
+ "learn/scheduled-jobs",
+ "learn/processors",
+ "learn/integrations",
+ "learn/ecommerce"
+ ]
+ },
+ {
+ "group": "Professional",
+ "pages": [
+ "learn/mcp-servers",
+ "learn/multi-channel",
+ "learn/dynamic-jobs",
+ "learn/production-ops",
+ "learn/full-project"
+ ]
+ }
+ ]
+ },
{
"tab": "Overview",
"groups": [
diff --git a/learn/authentication.mdx b/learn/authentication.mdx
new file mode 100644
index 0000000..27de513
--- /dev/null
+++ b/learn/authentication.mdx
@@ -0,0 +1,92 @@
+---
+title: "Lesson 1: Authentication"
+description: "Set up the Lua CLI and authenticate your account"
+---
+
+
+**Beginner** | 5 min | Lesson 1 of 18
+
+
+## What you'll learn
+
+- Run the Lua CLI
+- Authenticate your account interactively
+- Verify your setup works
+
+## Interactive Terminal
+
+Use the terminal below to follow along. `lua-cli` is pre-installed and ready to use.
+
+
+
+## Step 1: Check the CLI
+
+The Lua CLI is pre-installed in the terminal above. Verify it's working:
+
+```bash
+lua --version
+```
+
+You should see the version number printed.
+
+## Step 2: Authenticate
+
+Run the authentication command — the CLI will guide you through the process interactively:
+
+```bash
+lua auth configure
+```
+
+The CLI will ask you to choose between:
+- **API Key** — paste your key when prompted
+- **Email OTP** — enter your email, check your inbox for the code, then enter it
+
+
+**Don't have an API key?** No worries — choose the email option. The CLI will send a one-time code to your inbox.
+
+
+## Step 3: Verify
+
+Once authenticated, check that everything is connected:
+
+```bash
+lua agents
+```
+
+You should see your organizations and agents listed. If you're brand new, the list may be empty — that's fine! We'll create an agent in the next lesson.
+
+## Knowledge Check
+
+
+
+ `lua auth configure` — this launches the interactive authentication wizard where you choose between API key or email OTP.
+
+
+ 1. **API Key** — if you already have one, paste it when prompted
+ 2. **Email OTP** — the CLI sends a 6-digit code to your email
+
+
+ Run `lua agents` to list your organizations and agents. If it returns results (or an empty list without errors), you're authenticated.
+
+
+
+## Next Steps
+
+
+
+ Create and configure your first AI agent
+
+
+ Full authentication command reference
+
+
diff --git a/learn/data-and-search.mdx b/learn/data-and-search.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/data-and-search.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/dynamic-jobs.mdx b/learn/dynamic-jobs.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/dynamic-jobs.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/ecommerce.mdx b/learn/ecommerce.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/ecommerce.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/full-project.mdx b/learn/full-project.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/full-project.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/integrations.mdx b/learn/integrations.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/integrations.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/mcp-servers.mdx b/learn/mcp-servers.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/mcp-servers.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/multi-channel.mdx b/learn/multi-channel.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/multi-channel.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/persona-design.mdx b/learn/persona-design.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/persona-design.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/processors.mdx b/learn/processors.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/processors.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/production-ops.mdx b/learn/production-ops.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/production-ops.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/push-and-deploy.mdx b/learn/push-and-deploy.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/push-and-deploy.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/scheduled-jobs.mdx b/learn/scheduled-jobs.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/scheduled-jobs.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/skills-and-tools.mdx b/learn/skills-and-tools.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/skills-and-tools.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/testing.mdx b/learn/testing.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/testing.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/user-state.mdx b/learn/user-state.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/user-state.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/webhooks.mdx b/learn/webhooks.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/webhooks.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+
diff --git a/learn/your-first-agent.mdx b/learn/your-first-agent.mdx
new file mode 100644
index 0000000..c5cbe1b
--- /dev/null
+++ b/learn/your-first-agent.mdx
@@ -0,0 +1,8 @@
+---
+title: "Coming Soon"
+description: "This lesson is under development"
+---
+
+
+This lesson is currently being developed. Check back soon!
+