A blog-ready 11ty starter based on PostCSS and Snowpack, with a RSS feed and Native Elements.

Key features

📰 Integrated RSS Feed.

💅 PostCSS with PostCSS Preset Env and cssnano to enhance and clean your css.

🏅 No CSS or JS frameworks to remove. Just add what you need.

📝 Basic blog structure.

📦 Basic building with Snowpack.

🎚 Configuration file to set meta data and global settings.

🎨 Code highlights which you can disable with a flag.

⚡️ Superpowered HTML elements with Native Elements.

⚠️ Custom 404 page layout

🤖 Custom blog posts parser to create

⚙️ Service Worker generated by eleventy-plugin-pwa

Preconfigured tools

• Eleventy for templates and site generation
• PostCSS and PostCSS Preset Env to process your CSS
• cssnano to minimize, merge and optimize the CSS output
• Snowpack for a simple asset build pipeline
• What Input to show outline only when navigating with keyboard

Prerequisites

• Node.js & npm
• Yarn

Usage

You can download the scaffolding to create a new project structure with one command:

npx degit equinusocio/xity-starter#main

This command will download the project to your current working directory and remove the

.github

.vscode

yarn install

Running the local development mode

This command will run

eleventy

snowpack

yarn start

Building the production version

To generate your static site you can run the following command. It will build the project and run optimisations for a production release inside the

/build

yarn build

More commands

XITY provides also two more commands useful to update dependencies and the cssdb used by Browserslist and PostCSS:

# Update dependencies interactively
yarn update:deps

Update the cssdb definitions. Run it every month.
yarn update:cssdb
Run prettier against md, css, and js files
yarn lint

Configurations

You can easily configure your site by changing the settings inside the

xity.config.js

Here are the default settings you will get with this project structure:

{
  /**
   * Site data
   */
  name: 'XITY - Eleventy blog/site starter',
  shortDesc: "I'm Mattia Astorino, UX Engineer in Milan and member of Open Source Design.",
  url: 'https://xity-starter.netlify.app',
  lang: 'en',
  /**
   * Socials and monetisation
   */
  authorHandle: '@equinusocio',
  authorName: 'Mattia Astorino',
  paymentPointer: '$ilp.uphold.com/9ebKEYaNiGUf',
  /**
   * Content settings
   */
  syntaxTheme: 'prism-material-light.css',
  permalinkClass: ['permalink'],
  iframeClass: ['iframes-wrapper'],
  codeClass: ['code-wrapper'],
  figureClass: ['figure'],
  /**
   * Main navigation items.
   * Used by components/header.njk
   */
  navigation: [
    {
      text: 'Home',
      url: '/',
      external: false,
    },
    {
      text: 'Blog',
      url: '/blog/',
      external: false,
    },
    {
      text: 'Sample Page',
      url: '/sample-page/',
      external: false,
    },
    {
      text: 'GitHub',
      url: 'https://github.com/equinusocio/xity-starter',
      external: true,
    },
  ],
}