How darkroomengineering/satus works
Satūs is a Next.js starter for content-driven marketing and creative sites. Its main user path is the site landing page and routed content, rendered inside a shared experience wrapper; Sanity can supply CMS pages and articles, while SEO and agent-facing routes expose site content to crawlers and LLMs. Optional branches provide Shopify commerce, form-provider integrations, motion, and WebGL. The sampled sources show the wrapper, feature loading, route handling, and webhook dispatch; other documented capabilities are included without asserting unsampled call paths.
Main entry points: client.ts Shopify storefront · features/index.tsx Optional feature loader · routes.ts CMS route catalog · wrapper/index.tsx Page wrapper
Components 28
Site experience
- Manual homepage
app/(site)/page.tsx - Content routes
app/(site)/[...slug]/page.tsx - Article pages
app/(site)/articles/[slug]/page.tsx - Page wrapper
components/layout/wrapper/index.tsx
Content and discovery
- Sanity Studio
app/studio/[[...tool]]/studio.tsx - Sanity client
lib/integrations/sanity/client.ts - CMS route catalog
lib/seo/routes.ts - Markdown content endpoint
app/agent-content/route.ts - LLM site summary
app/llms.txt/route.ts - SEO and metadata
lib/seo/site.ts - Sitemap
app/sitemap.ts
Optional integrations
- Shopify storefront
lib/integrations/shopify/client.ts - Cart ensure endpoint
app/api/cart/ensure/route.ts - Revalidation dispatch
app/api/revalidate/route.ts - Sanity revalidation
lib/integrations/sanity/revalidate.ts - Shopify revalidation
lib/integrations/shopify/revalidate.ts - Integration registry
lib/integrations/registry.ts - Mailchimp client
lib/integrations/mailchimp/mailchimp-client.ts
Interactive runtime
- Optional feature loader
lib/features/index.tsx - GSAP runtime
components/effects/gsap.tsx - WebGL canvas
lib/webgl/components/canvas/index.tsx - Development tools
lib/dev/index.tsx
Shared services
- Validated environment
lib/env.ts - Rate limiting
lib/utils/rate-limit.ts
Other components
- Site visitor
- Sanity CMS
- Shopify API
- Mailchimp API
Connections 28
- Site visitor → Manual homepage: opens manual
README.md - Manual homepage → Page wrapper: renders in
app/(site)/page.tsx - Content routes → Page wrapper: renders in
app/(site)/[...slug]/page.tsx - Article pages → Page wrapper: renders in
app/(site)/articles/[slug]/page.tsx - Page wrapper → Optional feature loader: mounts runtime
- Sanity Studio → Sanity client: uses CMS
- CMS route catalog → Sanity client: fetches content
lib/seo/routes.ts - CMS route catalog → Sanity CMS: queries routes
lib/seo/routes.ts - Article pages → Sanity CMS: loads articles
- Markdown content endpoint → SEO and metadata: builds document
app/agent-content/route.ts - LLM site summary → CMS route catalog: gets CMS routes
app/llms.txt/route.ts - LLM site summary → SEO and metadata: uses site details
app/llms.txt/route.ts - Sitemap → CMS route catalog: lists CMS routes
README.md - Shopify storefront → Shopify API: requests storefront
lib/integrations/shopify/client.ts - Cart ensure endpoint → Shopify storefront: ensures cart
- Revalidation dispatch → Rate limiting: limits requests
app/api/revalidate/route.ts - Revalidation dispatch → Shopify revalidation: dispatches Shopify
app/api/revalidate/route.ts - Revalidation dispatch → Sanity revalidation: dispatches Sanity
app/api/revalidate/route.ts - Sanity revalidation → Sanity CMS: revalidates content
- Shopify revalidation → Shopify API: handles webhook
- Shopify storefront → Integration registry: checks setup
lib/integrations/shopify/client.ts - Mailchimp client → Integration registry: checks setup
lib/integrations/mailchimp/mailchimp-client.ts - Mailchimp client → Mailchimp API: submits contacts
lib/integrations/mailchimp/mailchimp-client.ts - Shopify storefront → Validated environment: reads configuration
lib/integrations/shopify/client.ts - Mailchimp client → Validated environment: reads configuration
lib/integrations/mailchimp/mailchimp-client.ts - Optional feature loader → GSAP runtime: loads optionally
lib/features/index.tsx - Optional feature loader → WebGL canvas: loads canvas
lib/features/index.tsx - Optional feature loader → Development tools: loads in development
lib/features/index.tsx