Internal Framework Docs · v0.170.x

Swift Web
Official Docs

A Nuxt 4 framework with ISR-driven performance and AI-native development conventions.
44 unstyled components, 16 Composables, strict guardrails — ready out of the box.

Get Started →Components
sw create YC001-WEB-project-name

Quick Access

Quick Start →

Create and run your first project in 5 minutes

Components →

Browse all Sw* component Props, Events, and interactive Demos

CLI Reference →

sw create / config / add / info / upgrade / run commands

Framework Config →

All swiftConfig configuration options

Framework Capabilities

AI-Native Dev Conventions

Strict guardrails + MCP integration let Claude Code and other AI tools invoke sw commands directly. Clear rules produce predictable AI output and reduce review cost

ISR-Driven Performance

ISR is the default rendering strategy, preventing CPU spikes under high concurrency. All pages must explicitly declare their render mode — no accidental SSR

CLI One-Command Setup

sw create fetches the latest starter in real time and enables theme / i18n / PWA / WebSocket on demand; starter ships a built-in .mcp.json so the AI toolchain works out of the box

44 Unstyled Components

Buttons, modals, uploaders, players, rich-text, QR codes, rails/carousels, ad slots and more — functionality only, styles are fully customizable, no CSS framework lock-in

All-in-One SEO / GEO

useSeo() emits og:* / canonical / robots / JSON-LD in one call; Movie / TVSeries / VideoObject structured data lets AI search understand and cite you; one-switch AI crawler policy; noindex for private pages

Zero-Config Sitemap

Built-in @nuxtjs/sitemap (with robots + schema-org): static routes auto-included, private paths auto-excluded; dynamic detail pages plug in via sitemap.sources — one pipeline, zero setup

Optional Theme System

Built-in light / dark / auto modes — useTheme() switches and persists in one call; disable when unused to add zero bundle overhead

Multi-Language i18n

On-demand @nuxtjs/i18n integration supporting zh-CN / zh-TW / en; disable for single-locale projects to keep the bundle lean

PWA Offline Support

Service Worker auto-generated, supports "Add to Home Screen" and offline cache; opt-in at project creation, zero overhead when disabled

Auth Route Guards

login.global / guest.global middleware — configure via auth.guardedPaths / guestPaths with zero custom code required

Ad Primitives & Unified Tracking

9 self-rendering SwAd* ad components (built-in impression/click tracking) + a group WebSDK tracking foundation; useTracker / useAdTrack report events and auto-degrade silently when unconfigured

Production JS Obfuscation

javascript-obfuscator runs automatically on production builds; skipped in dev mode so debugging stays comfortable

Ecosystem

@swift-web/cli

Scaffolding CLI — sw create bootstraps projects, sw config manages settings, sw add generates files, sw run executes scripts, starter ships .mcp.json so AI tooling works out of the box

CLI Reference →
+

@swift-web/standards

Single source of truth for ecosystem conventions: dev SOP, AI collaboration rules, commit / branch conventions, plus distributable ESLint / Prettier / Stylelint configs and commit-msg validation, synced into every repo

View Standards →
→

@swift-web/framework

Nuxt Module that registers 44 components, 16 Composables, 2 Stores, global route guards, theme, i18n and more

Component Docs →
→

@swift-web/starter

Project template published to the verdaccio registry. sw create fetches the latest via npm pack at run time, with framework integration and demo pages

Get Started →