docs(academy): Academy learning surface by ouiliame · Pull Request #5170 · simstudioai/sim

ouiliame · 2026-06-22T20:29:19Z

Summary

Introduces the Academy — a video-first learning surface for Sim — into the docs site.

Academy section in the docs: navbar tab + dedicated academy tree with a course layout (preview cards, chapters, "what you'll learn", progress).
Self-hosted video player (VideoPlaceholder) streaming MP4 from Vercel Blob — no YouTube. Chapter rows seek the player (academy:seek), with real timestamps per video.
Sectioned IA: Get Started → Workflows (Intro, Logs, Branching, Loops & Parallel, Subworkflows, Deployment) → Agents → Tables → Files → Knowledge Bases.
Block diagrams (WorkflowPreview) embedded in every lesson, and a "Related documentation" section linking each lesson into the reference docs.

Scope & future home

This PR lands the Academy in the docs as its preliminary home. It is not necessarily the long-term home:

We're exploring moving the lesson content into a separate CMS for easier authoring/management.
Longer term the Academy may live on its own surface (e.g. academy.sim.ai) rather than under the docs.

Notes

Docs-only change; no runtime/product/auth paths touched.
type-check + build green; all lessons render locally. Branch is up to date with staging.
The Logs lesson hero is a "Coming soon" placeholder until its video is recorded.

…ership workflow edits via sockets, ui improvements

…hog upgrade

…lama fix

…ng improvements, posthog, secrets mutations

…ration, signup method feature flags, SSO improvements

* feat(posthog): Add tracking on mothership abort (simstudioai#4023) Co-authored-by: Theodore Li <theo@sim.ai> * fix(login): fix captcha headers for manual login (simstudioai#4025) * fix(signup): fix turnstile key loading * fix(login): fix captcha header passing * Catch user already exists, remove login form captcha

…nts, secrets performance, polling refactors, drag resources in mothership

… enterprises

…ension

…y invalidation, HITL docs

…endar triggers, docs updates, integrations/models pages improvements

…ups ui

…ions, jira forms endpoints

…mat, logs performance improvements fix(csp): add missing analytics domains, remove unsafe-eval, fix workspace CSP gap (simstudioai#4179) fix(landing): return 404 for invalid dynamic route slugs (simstudioai#4182) improvement(seo): optimize sitemaps, robots.txt, and core web vitals across sim and docs (simstudioai#4170) fix(gemini): support structured output with tools on Gemini 3 models (simstudioai#4184) feat(brightdata): add Bright Data integration with 8 tools (simstudioai#4183) fix(mothership): fix superagent credentials (simstudioai#4185) fix(logs): close sidebar when selected log disappears from filtered list; cleanup (simstudioai#4186)

v0.6.46: mothership streaming fixes, brightdata integration

…m integration, atlassian triggers

…he TOC Chapter rows wrapped instead of truncating (items-start, break-words) so longer titles aren't clipped. Workflows lesson set full:true so the fumadocs 'On this page' TOC is hidden — the Chapters panel was competing with it and clipping at the right edge. Chapters is now the sole right-side panel. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ody full-width - page.tsx: for slug[0] === 'academy', disable the "On this page" TOC and set full width. The video hero/content gets the room; normal docs keep their TOC. - Lesson layout: chapters panel now sits only in the top section beside the intro + "What you'll learn" (grid items-start, so it takes only the height it needs, no longer stretching to the bottom). The body sections flow full-width below the grid so their text wraps across the page instead of a narrow column. - VideoChapters: titles wrap (items-start, break-words) rather than truncate. Workflows is the template; rolling out to the other lessons once confirmed. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…my video URLs Applied the Workflows template (full-width hero → intro + "What you'll learn" + Chapters → full-width body) to every remaining lesson, written from the recording outlines: - Agents: an AI agent IS a workflow; the Agent block as a programmatic chat; tools and skills; making a deterministic workflow agentic; composing intelligence (scaling outro). - Knowledge Bases: the context problem; documents + connectors; auto index/embed/chunks; search by meaning + similarity; grounding with citations. - Tables: spreadsheet shape; business work as operations over data; workflow columns at scale. - Files: why files exist; consume and produce; familiar automatable examples. - Use cases (Slack triage, document extraction, monitoring & research, sales enrichment): hype scaffolds with build-step chapters, each noting the foundations it composes. Also fixed getAssetUrl: absolute URLs now pass through instead of getting a leading slash, so the blob-hosted academy videos resolve (was src="/https://…"). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

VideoPlaceholder now always renders the design-system preview card and takes a `youtube` prop (id or URL). With a video set, the play button is active and loads an inline youtube-nocookie embed on click; without one, the card reads "Coming soon" with a muted play button. No more inline blob videos / autoplay. Dropped the blob academy-preview srcs from every lesson — they're preview cards until each gets its `youtube="..."`. Stops the 01-intro video from autoplaying on What is Sim. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

vercel · 2026-06-22T20:29:28Z

@ouiliame is attempting to deploy a commit to the Sim Team on Vercel.

A member of the Team first needs to authorize it.

…ted docs - VideoPlaceholder plays self-hosted MP4 (Vercel Blob via getAssetUrl) instead of YouTube; resolves absolute URLs, /static paths, and bare asset names - Restructure foundations into sections: Get Started, Workflows (intro, branching, loops, subworkflows), Agents, Tables, Files, Knowledge Bases — each topic a folder with an intro page; eyebrows match their section - Wire all uploaded lesson videos; scaffold the three Workflows sub-lessons - Add a "Related documentation" section to every lesson linking the reference docs; fix in-body cross-links broken by the folder move Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

vercel · 2026-06-22T23:06:14Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jun 22, 2026 11:33pm

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ows, deployment) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

greptile-apps · 2026-06-23T23:24:16Z

Too many files changed for review. (117 files found, 100 file limit)

cursor · 2026-06-23T23:24:24Z

PR Summary

Low Risk
Docs-site and content-only changes (navbar, layout, MDX, static video URLs); no product runtime, auth, or data paths. Main risk is link/URL drift and size of the content tree, not production behavior.

Overview
Adds a video-first Academy to the docs app: a navbar Academy tab, a sectioned course tree (Get Started → Workflows → Agents → Tables → Files → Knowledge Bases → use cases), and lesson pages built from shared UI.

Lesson experience: VideoPlaceholder plays self-hosted MP4s (Blob CDN or absolute URLs); VideoChapters seeks via academy:seek; WhatYouWillLearn and optional CourseProgress / chapter rails layout lessons. Academy routes use full-width layout and disable the page TOC so heroes and in-page chapters have room. getAssetUrl now passes through https:// sources unchanged.

Content: Publishes core Academy MDX (workflows, agents, tables, files, KBs, use cases) with embedded WorkflowPreview diagrams and Related documentation links into reference docs. A large academy/drafts/ tree holds future modules (Chat, deployment, partner cert, etc.). Internal planning artifacts (.plans/integrations-ia.md, DOCS_PLAN.md, visuals-manifest.md) document broader docs IA and screenshot backlog. .gitignore adds **/.source/ for Fumadocs-generated dirs.

^{Reviewed by Cursor Bugbot for commit 6c0194c. Bugbot is set up for automated code reviews on this repo. Configure here.}

cursor

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

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit a994418. Configure here.}

Each academy lesson had video + prose + objectives but no diagram. Adds a live <WorkflowPreview> (the docs' block-canvas renderer — same visual language as the explainer videos) to all 13 lessons, using the curated example that matches each topic: workflows/intro→CLASSIFY_REPLY, branching→CONDITION_ROUTE, loops→LOOP, subworkflows→WORKFLOW_CALL, deployment→RESPONSE_API, agents→CLASSIFY, tables→TABLE_ENRICH, files→FILE_SUMMARY, knowledge-bases→SUPPORT_KB, and the four use-cases (ROUTER_TRIAGE, FILE_SUMMARY, API_FETCH, TABLE_ENRICH). Additive MDX only; placed after each lesson's first explanatory section with a short lead-in. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…scenes Two fixes to the lesson VideoChapters: - Seeking: the chapter rows were inert buttons. VideoChapters (now a client component) dispatches an `academy:seek` event with the parsed time; the VideoPlaceholder video listens, starts playback if needed, and jumps there (via a ref + pending-seek applied on loadedmetadata). - Timestamps: chapters were hand-guessed and didn't match the videos. Every lesson's chapters are now derived from its render — one chapter per scene at (intro duration + the scene's manifest `at` time), with an Introduction chapter at 0:00. Times now line up with the actual stitched-with-intro video. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- Chapter titles were raw internal scene names ("Swap the decider", "KB appears", "Two schedules one shape") — rewrote all of them across the 8 video lessons into clean, learner-facing labels (times unchanged). - Removed the WorkflowPreview diagrams from the four use-case lessons: they used generic stand-in example workflows that misrepresented the specific use case. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

New workflows/logs lesson: every run leaves a complete record, and debugging is reading that record backwards from the symptom to its source. Prose + objectives + a ROUTER_TRIAGE diagram + chapters (ready for the render). Video is "Coming soon" for now (no on-camera intro yet); the lesson stands on its own and slots into the Workflows track after intro, before branching. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

ouiliame · 2026-06-24T21:58:07Z

@waleedlatif1 ready to merge when you have a chance. Adds the Academy docs section — docs only, no runtime/auth changes.

…urce A fumadocs-generated .source/ got committed under content/docs/en/academy and failed biome (noBannedTypes, unsorted imports). It's unused — the app serves academy via the root @/.source/server. Remove it and ignore nested .source dirs. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

ouiliame · 2026-06-25T20:57:48Z

Superseded by #5213 — clean single-commit history, drops the committed preview MP4s (91MB) and all draft MDX. Same live content.

waleedlatif1 and others added 30 commits April 3, 2026 23:30

v0.6.23: MCP fixes, remove local state in favor of server state, moth…

0b9019d

…ership workflow edits via sockets, ui improvements

v0.6.24: copilot feedback wiring, captcha fixes

a54dcbe

v0.6.25: cloudwatch, cloudformation, live kb sync, linear fixes, post…

28af223

…hog upgrade

v0.6.26: ui improvements, multiple response blocks, docx previews, ol…

d889f32

…lama fix

v0.6.27: new triggers, mothership improvements, files archive, queuei…

316bc8c

…ng improvements, posthog, secrets mutations

v0.6.28: new docs, delete confirmation standardization, dagster integ…

3f508e4

…ration, signup method feature flags, SSO improvements

v0.6.30: slack trigger enhancements, connectors performance improveme…

d7da35b

…nts, secrets performance, polling refactors, drag resources in mothership

v0.6.31: elevenlabs voice, trigger.dev fixes, cloud whitelabeling for…

cf233bb

… enterprises

v0.6.32: BYOK fixes, ui improvements, cloudwatch tools, jsm tools ext…

f8f3758

…ension

v0.6.33: polling improvements, jsm forms tools, credentials reactquer…

3c8bb40

…y invalidation, HITL docs

v0.6.34: trigger.dev fixes, CI speedup, atlassian error extractor

d33acf4

v0.6.35: additional jira fields, HITL docs, logs cleanup efficiency

4f40c4c

v0.6.36: new chunkers, sockets state machine, google sheets/drive/cal…

cbfab1c

…endar triggers, docs updates, integrations/models pages improvements

v0.6.37: audit logs page, isolated-vm worker rotation, permission gro…

4309d06

…ups ui

v0.6.38: models page

8b57476

v0.6.39: billing fixes, tools audit, landing fix

e3d0e74

v0.6.40: mothership tool loop, new skills, agiloft, STS, IAM integrat…

0ac0539

…ions, jira forms endpoints

v0.6.41: webhooks fix, workers removal

3838b6e

v0.6.42: mothership nested file reads, search modal improvements

fc07922

v0.6.43: mothership billing idempotency, env var resolution fixes

3a1b1a8

v0.6.44: streamdown, mothership intelligence, excel extension

46ffc49

Merge pull request simstudioai#4190 from simstudioai/staging

c0bc62c

v0.6.46: mothership streaming fixes, brightdata integration

v0.6.46: mothership queueing, web vitals

387cc97

v0.6.47: files focusing, documentation, opus 4.7

2dbc7fd

v0.6.48: import csv into tables, subflow fixes, CSP updates

8a50f18

v0.6.49: deploy sockets event, resolver, logs improvements, monday.co…

dcf3302

…m integration, atlassian triggers

v0.6.50: ppt/doc/pdf worker isolation, docs, chat, sidebar improvements

bc09865

v0.6.51: tables improvements, billing fixes, 404 pages, code hygiene

5f56e46

ouiliame and others added 5 commits June 17, 2026 17:54

Merge remote-tracking branch 'origin/staging' into feat/docs-academy

9623063

Merge remote-tracking branch 'origin/staging' into feat/docs-academy

ec0ac4a

vercel Bot deployed to Preview June 22, 2026 23:11 View deployment

academy: add Workflows · Deployment lesson after Subworkflows

6f2de68

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview June 22, 2026 23:22 View deployment

academy: write the Workflows sub-lessons (branching, loops, subworkfl…

a994418

…ows, deployment) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview June 22, 2026 23:33 View deployment

ouiliame marked this pull request as ready for review June 23, 2026 23:24

ouiliame marked this pull request as draft June 23, 2026 23:24

cursor Bot reviewed Jun 23, 2026

View reviewed changes

Comment thread apps/docs/components/ui/video-chapters.tsx

ouiliame and others added 5 commits June 24, 2026 13:53

academy: sort tailwind classes in VideoPlaceholder (biome)

9576abc

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

ouiliame marked this pull request as ready for review June 24, 2026 21:57

ouiliame mentioned this pull request Jun 25, 2026

docs: Academy learning surface #5213

Merged

ouiliame closed this Jun 25, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(academy): Academy learning surface#5170

docs(academy): Academy learning surface#5170
ouiliame wants to merge 121 commits into
simstudioai:stagingfrom
ouiliame:feat/docs-academy

ouiliame commented Jun 22, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jun 22, 2026

Uh oh!

vercel Bot commented Jun 22, 2026 •

edited

Loading

Uh oh!

greptile-apps Bot commented Jun 23, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Jun 23, 2026 •

edited

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

ouiliame commented Jun 24, 2026 •

edited

Loading

Uh oh!

ouiliame commented Jun 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

ouiliame commented Jun 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Scope & future home

Notes

Uh oh!

vercel Bot commented Jun 22, 2026

Uh oh!

vercel Bot commented Jun 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps Bot commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ouiliame commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ouiliame commented Jun 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ouiliame commented Jun 22, 2026 •

edited

Loading

vercel Bot commented Jun 22, 2026 •

edited

Loading

greptile-apps Bot commented Jun 23, 2026 •

edited

Loading

cursor Bot commented Jun 23, 2026 •

edited

Loading

ouiliame commented Jun 24, 2026 •

edited

Loading