Swifty

Super Speedy Static Site Generator

Swifty uses convention over configuration to make it super simple to build blazingly fast static sites.

Features

• Markdown pages with YAML front matter
• Automatic image optimization to WebP
• Layouts and partials for reusable templates
• Auto-injected CSS/JS from your css/ and js/ folders
• Code syntax highlighting via highlight.js
• Tags and navigation generated automatically
• RSS feed generation for blogs and content folders
• Draft mode for work-in-progress pages (visible in dev, hidden in production)
• Scheduled publishing via future dates in front matter
• Optional Turbo for SPA-like transitions

Quickstart

npm install @daz4126/swifty
npx swifty init
npx swifty start

Then visit http://localhost:3000

Project Structure

your-site/
├── pages/          # Markdown content (folder structure = URLs)
├── layouts/        # HTML layout templates
├── partials/       # Reusable content snippets
├── css/            # Stylesheets (auto-injected)
├── js/             # JavaScript (auto-injected)
├── images/         # Images (auto-optimized to WebP)
├── template.html   # Base HTML template
└── config.yaml     # Site configuration

Commands

npx swifty init             # Create new project structure
npx swifty build            # Build static site to dist/ (for production)
npx swifty start            # Build, watch, and serve at localhost:3000 (for development)
npx swifty build --out dir  # Build to custom output directory

Development vs Production

• swifty start - For development. Includes live reload (auto-refreshes browser on file changes) and file watching with incremental builds for CSS/JS/images.
• swifty build - For production deployment. Produces clean output without any development scripts.

Documentation

See the full documentation for details on configuration, layouts, partials, and more.