Skip to content

docs(academy): Academy learning surface#5170

Draft
ouiliame wants to merge 115 commits into
simstudioai:stagingfrom
ouiliame:feat/docs-academy
Draft

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

Conversation

@ouiliame

Copy link
Copy Markdown
Contributor

Summary

Adds the Academy learning surface to docs — a video-first course layout for learning Sim.

  • New Academy root tree + navbar tab
  • Foundations track rebuilt as a flat course (no landing hub), modules resequenced (Workflows before Chat, Logs before Deployment)
  • 16+ lessons wired in the course layout with real video timelines; preview cards everywhere, Play loads the YouTube video
  • Module rename: Mothership → Chat (Sim is the agent, Chat is the surface), per the updated positioning constitution
  • Page-type badge infra (pageType frontmatter + badge render)
  • Preview videos wired from blob storage + local static fallbacks

Notes

  • Merged latest origin/staging into the branch; type-check passes clean across all workspaces.

🤖 Generated with Claude Code

waleedlatif1 and others added 30 commits April 3, 2026 23:30
…ership workflow edits via sockets, ui improvements
…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
…endar triggers, docs updates, integrations/models pages improvements
…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
ouiliame and others added 16 commits June 11, 2026 19:44
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
# Conflicts:
#	apps/docs/components/page-type-badge.tsx
…ace)

Same convention as the docs branch. The mothership/ module is renamed to chat/
and rebranded: "Chat" for the surface/place, "Sim" for the agent that acts
(scaffolds, generates, debugs). Copilot pairings collapse into "Sim". Lesson
content is kept (build loop, non-determinism, debugging, prototype→promote) —
only the branding changes.

Also: introduction/mothership-and-workflows → chat-and-workflows;
logs-debugging/debugging-with-mothership → debugging-with-chat; top + module
meta.json entries and all /academy/mothership links updated. The 02-mothership
.mp4 asset URL is left as-is (the recorded file's real name).

Build clean, 0 broken /academy links.

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

Two prerequisite fixes. Workflows now precedes Chat: the Chat module's own
thesis says it 'sits above the primitives but doesn't replace understanding
them,' so learners need workflow literacy before they can evaluate what Sim
scaffolds. Logs & Debugging now precedes Deployment: verify a run before
publishing it live. meta.json sidebar order and the top index module cards
both updated to match.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Restructured the Academy to the first set of videos: a single "What is Sim?"
entry (now the /academy index — lands straight on the lesson, no separate hub
page), five foundation videos (Workflows, Agents, Knowledge Bases, Tables,
Files), and four use-case builds (Slack IT triage, document extraction,
monitoring & research, sales data + enrichment).

Concept pages written from the recording outlines — Workflows and Agents carry
the inspirational "simple primitives scale to your ambition" outro. Existing
footage wired up (01-intro, 03-tables, 04-knowledge-base, 06-agents, 05-files);
Workflows + use cases are placeholders for the new recordings.

All prior modules (chat, deployment, logs-debugging, agents-tools-mcp-skills,
workspaces, partner-certification, old walkthroughs) parked under drafts/ —
preserved, out of the nav, available as phase 2.

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

Rewrote components/ui/video-placeholder.tsx to the claude.ai/design VideoCard
spec: radial-gradient surface, 64px blueprint grid masked to atmosphere, corner
plus marks, status pill, italic eyebrow, large clamp(40-88px) title, the real
sim logotype SVG wordmark, and a muted centered play button. Now theme-aware —
follows the docs light/dark via dark: variants (was dark-only).

Scope kept tight per request: only this one component changed. Styling is local
with literal color values — deliberately NOT wired to the design system's future
tokens/fonts (Season Sans, --sim-*), so no docs global styles are touched.

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

VideoCard: title/eyebrow were sized in vw, so on the wide docs layout the title
ballooned to 88px and rode up into the play button. Switched the card to a
container (container-type:inline-size) and sized type in cqi — title
clamp(2rem,8cqi,4rem), eyebrow clamp(13px,2.4cqi,20px) — so it stays bottom-
anchored and proportional to the card, matching the design reference. COMING
SOON pill is now sans-serif (was mono).

workflows.mdx: the inspirational outro is now plain prose, not a Callout box.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The title and wordmark were independently bottom-anchored, so their baselines
didn't line up. Put both in one bottom-anchored items-baseline row (eyebrow
pulled out of flow above the title so the row's baseline is the title's), so
'Workflows' and 'sim' sit on the same line as in the design reference.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Match VideoCard.html: heading and wordmark are two bottom-anchored blocks
(left:40/bottom:40, right:40/bottom:40) again, not a flex row. Added not-prose
so docs typography margins stop lifting the title. Applied font-season — the
docs already ship Season Sans (app/fonts/season.ts → --font-season, .font-season
class), which is the design's var(--font-sans), so no font import needed. Title
bumped to clamp(2.5rem,9.5cqi,5.5rem) to match the design's scale.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- New VideoChapters component: right-rail "skip to chapter" panel styled like the
  course panels. Restored the two-column lesson layout on Workflows (video card
  full-width, then content left + sticky chapters right) — the slot the old
  CourseProgress used, now per-video chapters.
- WhatYouWillLearn: add not-prose. Docs typography was adding margins to its
  heading/paragraphs on top of the component's own spacing, blowing out the gaps.

Workflows is the template; rolling out to the other lessons once confirmed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…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

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

@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

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

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

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

Request Review

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>
@ouiliame ouiliame marked this pull request as ready for review June 23, 2026 23:24
@greptile-apps

greptile-apps Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

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

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

cursor Bot commented Jun 23, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Docs-only changes (content, UI components, routing flags); no runtime product or auth paths affected. Main follow-up risk is link drift between Academy drafts and live doc URLs until drafts are promoted or hidden.

Overview
Introduces Academy as a separate docs tree with its own navbar tab, aimed at video-first lessons that complement the main documentation.

UX and layout: Academy routes use full-width pages and hide the “On this page” TOC so lesson heroes and players have room. New MDX building blocks include a themed video hero (inline play from blob or static URLs, “coming soon” when no src), What you will learn, Video chapters, and Course progress side panels. getAssetUrl now passes through absolute http(s) URLs for hosted lesson media.

Content: A flat foundations course is wired via academy/meta.json (Get Started → Workflows → Agents → Tables/Files/KB → use cases). Published lessons cover workflows (intro, branching, loops, subworkflows, deployment), agents, tables, files, knowledge bases, and several use-case walkthroughs, mostly with preview videos and chapter rails. A large academy/drafts/ tree holds additional module scripts (Chat/Mothership rename, deployment, logs, partner certification, etc.) for future publishing. Planning artifacts DOCS_PLAN.md, integrations-ia.md, and visuals-manifest.md document the broader docs IA and media backlog.

Infra: Fumadocs .source stubs under academy/ support the MDX collection; academy .source config mirrors optional pageType frontmatter used elsewhere in the docs plan.

Reviewed by Cursor Bugbot for commit a994418. Bugbot is set up for automated code reviews on this repo. Configure here.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

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 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.

</span>
)}
</button>
</li>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Chapter buttons don't seek video

Medium Severity

VideoChapters renders clickable chapter rows with timestamps, but the buttons have no handlers and no link to the lesson VideoPlaceholder player. After play, chapter clicks still do nothing, so advertised in-page timelines don't work.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit a994418. Configure here.

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.

5 participants