Skip to main content

docs-v2

Superblocks external documentation site, powered by Mintlify. Published at https://docs.superblocks.com.

Commands

mintlify dev          # Local preview at http://localhost:3000
mintlify build        # Production build (usually handled by Mintlify deploy pipeline)

Structure

  • getting-started/ - Onboarding and quickstart guides
  • integrations/ - Integration-specific documentation
  • applications/ - Application building guides (pages, components, queries, workflows)
  • admin/ - Admin and organization settings
  • enterprise/ - Enterprise features (on-premise, SSO, audit logs)
  • components/ - UI component reference
  • scripts/ - Client-side JS (dropdown, TOC helpers)
  • docs.json - Mintlify configuration (navigation, theme, redirects, SEO)

Content Guidelines

  • All content is Markdown with Mintlify extensions (callouts, tabs, cards, accordions)
  • Navigation structure is defined in docs.json under the navigation key
  • Redirects are defined in docs.json under redirects
  • Images go in the appropriate content directory alongside their page
  • Auto-deploys on merge to main

Org-Wide Standards

For cross-repo architecture, security practices, observability, and prompt standards, see the org-level AGENTS.md in superblocksteam/workspace at repos/AGENTS.md.