Skip to content

Update code examples to Sillo v1, rebuild the nav, and split the bundle - #1

Open
TechWithDunamix wants to merge 3 commits into
mainfrom
v1
Open

TechWithDunamix wants to merge 3 commits into
mainfrom
v1

Conversation

@TechWithDunamix

Copy link
Copy Markdown
Member

Summary

  • Code examples now match Sillo v1. Every Python snippet on the site was written against the released 0.x API. They now use the single ctx: HttpContext handler, direct return values, request_model= with an injected body, useAuth() gates, TokenForUser, and setup_mail/send_template_email. Queue examples use enqueue() through a connection rather than Job.dispatch()/dispatch_after(), which the v1 docs flag as raising in every context. Verified against sillohq/core's v1.0 docs and source.
  • Nav rebuilt as mega-menus. The panel now drops below the bar instead of stretching it, with four shapes behind it: a Platforms grid of tall cards showing each product's real interface cropped at the card edge, and headed-column panels for Framework, Resources and About — including a featured item and a starter-kit file cascade.
  • Warder and Atlas added to the product data, built from their own READMEs so a preview cannot show a screen, column or state the product does not have.
  • The docs site's closing wordmark now ends every page, ported with its container-query sizing and downward mask rather than re-invented.
  • Bundle split. The site shipped as a single 548 kB chunk on every page.

Performance

before now (home)
JS to first paint 548 kB / 176 kB gz 231 kB / 77 kB gz

Three changes got it there:

  1. autoCodeSplitting on the router plugin, so /about, /craftman and /foreman no longer ship with the home page.
  2. The platforms grid is loaded on first open. Wiring the previews had made SiteNav import products.ts and AppMock, putting 47 kB of product data in the chunk every page fetched, to draw a menu most visitors never open.
  3. The WebGL hero is deferred — it pulled ogl (49.67 kB) into the critical path for decoration.

Plasma and the demo cursor already gated on IntersectionObserver and prefers-reduced-motion, so the cost was load-time, not runtime.

Test plan

  • bunx tsc --noEmit and bun run build pass (both clean locally)
  • Open each nav group: Platforms, Framework, Resources, About — panel drops below the bar, closes on Escape and on outside click, arrow keys move between triggers
  • Platforms panel: cards are ~3:4, previews crop at the bottom edge with no gap under them, cards link through
  • Check the panels at ~1000px and on a phone — grids collapse, the file cascade and previews drop out
  • Home page: hero renders before the WebGL wash arrives, code tabs switch without the panel resizing
  • Footer wordmark scales with the footer measure, not the viewport
  • Confirm the doc links added here resolve: docs.sillo.build/packages/, /guides/record/, /guides/work/queue/, /guides/work/scheduler/, /guides/services/mail/, and github.com/sillohq/starter

Note

design-v1/ was left untracked — it predates this branch and is not mine to commit.

🤖 Generated with Claude Code

TechWithDunamix and others added 3 commits September 11, 2026 15:45
Rewrites every Python snippet on the site (home page code tabs,
capability showcase, and the "magic stack" feature grid) from the
released 0.x request/response handler style to Sillo v1: single
ctx: HttpContext handlers, direct return values instead of
response.json(...), request_model + injected body params, useAuth()
route gates, JWTAuthBackend/TokenForUser, setup_mail/send_template_email
for mail, and enqueue() through a queue connection instead of the
broken Job.dispatch()/dispatch_after() classmethods. Verified against
the sillo/core v1.0 docs and source.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Drops the CTA button's hover shadow, the active-tab glow shadow in
the capability detail panel, and the bg-elevated tint on the two
featured bento cells — flat surfaces and borders only, no drop
shadows or elevated backgrounds.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Rebuilds the nav panel as a sheet that drops below the bar rather than
stretching it, with four panel shapes behind it: a platforms grid of tall
cards showing each product's real interface cropped at the card edge,
and headed-column panels for Framework, Resources and About, with a
featured item and a file cascade.

Adds Warder and Atlas to the product data, built from their own READMEs
so the previews cannot show a screen the product does not have, and
closes the page with the wordmark the docs site ends on.

The site shipped as one 548 kB chunk on every page. Route-level code
splitting, a lazily loaded platforms grid (it had put 47 kB of product
data in the chunk every page fetched, to draw a menu most visitors never
open) and a deferred WebGL hero take the home page to 231 kB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 11, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
website Ready Ready Preview Sep 11, 2026 6:41pm UTC

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