Repository navigation
Conversation
How volcano.dev runs on its own platform: the web app and docs site on Frontends, the REST, billing, and support APIs and the Stripe webhook on Functions, billing data in a Volcano database, and billing jobs on the scheduler. Includes a stack diagram. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AI review: no P0-P2 findingsThis PR adds an engineering blog post, "Volcano, built on Volcano", with a stack diagram, and lists it in ⚪ P3
Not checked: The AI review read the diff, the code, and the PR's text; it ran no tests or builds and read nothing outside this repository.
Human review: not needed |
| category: engineering | ||
| tags: [frontends, functions, database] | ||
| author: Mark Kim | ||
| published: "2026-11-19" |
There was a problem hiding this comment.
🟡 P2: New post will be listed after the older October post, so /blog is no longer newest first
BlogHome says the listing is "newest first" (src/components/blog-home.tsx:9). But getSectionPages (src/lib/sections.ts:60) and the category pages order posts only by navigation order from content/blog/meta.json. That file lists introducing-volcano-agent-cloud (2026-11-19) and introducing-volcano-sandbox (2026-10-19) by name, then "...". This post is picked up only through "...", so it comes last: below the October sandbox post on /blog, on /blog/category/engineering, and in the sidebar, even though it's dated 2026-11-19. To fix it, add "volcano-built-on-volcano" to meta.json before "introducing-volcano-sandbox". Put it after the launch post if that post should stay first among the same-day posts.
Found by claude-opus-5-5
There was a problem hiding this comment.
Fixed in 4fc6811: meta.json now names this post after the launch post and before the October sandbox post.
|
|
||
| Some of volcano.dev's most critical data sits in Volcano's own [database](/platform/databases/overview). Billing is the part where a mistake costs real money. | ||
|
|
||
| The Volcano scheduler runs our critical billing operations. Those jobs don't run on an outside cron service. They run on the same scheduler you'd use for your own jobs. |
There was a problem hiding this comment.
⚪ P3: Calls the scheduler a fourth primitive, but the docs treat it as part of Functions, and it has no link
The caption (line 18), this section, and line 44 call Frontends, Functions, the database, and the scheduler "four primitives". The diagram shows Scheduler as its own primitive box. The platform docs present cron scheduling as a Functions feature: content/platform/functions/scheduled-invocations.md, "Scheduled invocations" under Functions in content/platform/index.md, and the function-schedulers API reference. A reader looking for a separate scheduler product won't find one. Frontends, Functions, and the database each get a link, but the scheduler doesn't. Link /platform/functions/scheduled-invocations here, and consider describing it as Functions' scheduled invocations rather than a separate primitive.
Found by claude-opus-5-5
There was a problem hiding this comment.
Fixed in 4fc6811: billing jobs are now described as scheduled function invocations with a link to /platform/functions/scheduled-invocations, and the "four primitives" wording is gone.
Name the post in meta.json after the launch post so /blog stays newest first. Describe billing jobs as scheduled function invocations, link that page, and drop the "four primitives" count. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tracking
None.
Why
New users can't see that volcano.dev itself runs on Volcano. This post shows it, from the people who built it.
Summary
content/blog/volcano-built-on-volcano.md(categoryengineering, author Mark Kim, published 2026-11-19).public/blog/volcano-built-on-volcano/stack.png. The diagram shows the web app and docs on Frontends; the REST, billing, and support APIs and the Stripe webhook on Functions; billing data in a Volcano database; and billing jobs on the scheduler.cover, so its card shows the category icon.meta.jsonalready picks up new posts through....Verification
pnpm lint:docs content/blogpasses: docs OK.pnpm check:linkspasses: links OK, 221 routes checked.pnpm buildpasses, including search-index and server-trace checks;/blog/volcano-built-on-volcanois generated.🤖 Generated with Claude Code