Welcome to Quesby Boilerplate

Discover Quesby Boilerplate, a modern Eleventy boilerplate designed for content creators. Learn how to get started with this privacy-first static site generator.

Welcome to Quesby Boilerplate

Welcome to Quesby Boilerplate, a modern, privacy-first static site boilerplate built with Eleventy and designed specifically for content creators who value performance, accessibility, and ease of use.

What is Quesby Boilerplate?

Quesby Boilerplate is a comprehensive Eleventy starter template that combines the power of static site generation with modern web development practices. It's designed to help you create fast, secure, and maintainable websites without the complexity of traditional content management systems.

Key Highlights

  • Privacy-First: No tracking, no analytics, no third-party dependencies
  • Performance Optimized: Built for speed with modern web standards
  • Content Management: Integrated Decap CMS for easy content editing
  • Modern Stack: @quesby/core, Eleventy 3.0+, Sass/SCSS, and modern JavaScript
  • Accessibility: WCAG compliant out of the box
  • SEO Ready: Optimized for search engines

Why Choose Quesby Boilerplate?

For Content Creators

  • Easy Content Management: Decap CMS integration allows non-technical users to manage content
  • Markdown Support: Write content in Markdown with full syntax highlighting
  • Image Optimization: Automatic responsive image generation
  • Search Functionality: Built-in search with MiniSearch

For Developers

  • Easy Setup: Create new projects with npx create-quesby
  • Modern Tooling: Latest Eleventy features and best practices
  • Modular Architecture: Clean, maintainable code structure with @quesby/core
  • Customizable Themes: SCSS-based theming system with multiple built-in themes
  • CLI Tools: Powerful command-line tools for content creation
  • Build Optimization: Automatic asset optimization and minification

Quick Start

Getting started with Quesby Boilerplate is straightforward:

1. Create a New Project

Terminal window
npx create-quesby my-site
cd my-site

Note: Quesby recommends using pnpm as package manager. If you have Node.js 16.10+ or higher, you can use Corepack to automatically manage package managers:

Terminal window
corepack enable

2. Install Dependencies

Terminal window
pnpm install
# or
npm install

3. Start Development Server

Terminal window
pnpm serve
# or
npm run serve

4. Open Your Browser

Navigate to http://localhost:8080 to see your site in action.

5. Create Your First Post

Terminal window
npx quesby new post "Welcome to Quesby"

This command will:

  • Generate a unique ULID for your post
  • Create proper folder structure (ULID--slug)
  • Generate complete front matter
  • Set current date automatically

What You Get

Pre-configured Features

  • Blog System: Complete blog with categories and tags
  • Documentation: Built-in documentation system
  • Admin Interface: Decap CMS admin panel
  • Search: Client-side search functionality
  • Responsive Design: Mobile-first responsive layout

Development Tools

  • Live Reload: Automatic browser refresh during development
  • Sass Compilation: Automatic SCSS to CSS compilation with watching
  • Asset Optimization: Image and asset optimization
  • Build Pipeline: Optimized production builds
  • CLI Tools: Create new posts with npx quesby new post

Content Management

Quesby Boilerplate includes Decap CMS for easy content management and a powerful CLI tool for content creation:

Using the CLI Tool (Recommended)

The fastest way to create new blog posts:

Terminal window
npx quesby new post "Your Post Title"

This command will:

  • Generate a unique ULID for your post
  • Create proper folder structure (ULID--slug)
  • Generate complete front matter
  • Set current date automatically

Admin Access

  • Visit /admin to access the content management interface
  • Create and edit blog posts, pages, and documentation
  • Manage media files and site settings
  • Preview changes before publishing

Content Types

  • Blog Posts: Full-featured blog system with categories and tags
  • Documentation: Structured documentation with navigation
  • Pages: Custom pages with flexible layouts
  • Media: Image and file management

Customization

Themes

Quesby Boilerplate comes with a modern, customizable theme system:

  • SCSS Architecture: Modular and maintainable styles
  • Dark/Light Mode: Built-in theme switching
  • Customizable Colors: Easy color scheme customization
  • Responsive Design: Mobile-first approach

Configuration

  • Site Settings: Configure site metadata and settings
  • Build Options: Customize build process and output
  • Content Structure: Flexible content organization
  • SEO Settings: Configure search engine optimization

Performance Features

Built-in Optimizations

  • Image Optimization: Automatic WebP and AVIF generation
  • Asset Minification: CSS and JavaScript minification
  • Lazy Loading: Images load only when needed
  • Critical CSS: Above-the-fold CSS optimization

Modern Standards

  • HTTP/2 Ready: Optimized for modern web protocols
  • Progressive Enhancement: Works without JavaScript
  • Accessibility: WCAG 2.1 AA compliant
  • Performance: Lighthouse scores 90+ out of the box

Next Steps

Explore the Documentation

Join the Community

Get Support

  • Documentation: Comprehensive guides and tutorials
  • Examples: Sample content and configurations
  • Templates: Additional theme options

Why We Built This

Quesby Boilerplate was created to solve common problems in static site development:

  • Complexity: Many static site generators are too complex for simple use cases
  • Performance: Most solutions don't prioritize performance out of the box
  • Privacy: Many tools include tracking and analytics by default
  • Maintenance: Keeping dependencies updated and secure is time-consuming

We believe that creating great content shouldn't require a computer science degree. Quesby Boilerplate provides all the tools you need without the complexity.

Ready to Get Started?

Quesby Boilerplate is designed to get you up and running quickly while providing the flexibility to grow with your needs. Whether you're a blogger, developer, or content creator, Quesby Boilerplate provides the foundation for a modern, performant website.

Get started now or browse the documentation to learn more about what Quesby Boilerplate can do for your next project.


Quesby Boilerplate is an open-source project maintained by Green Panda Studio. We're committed to providing a privacy-first, performance-focused solution for modern web development.