https://github.com/philhawksworth/eleventail

A running start for JAMstack projects with Eleventy, TailwindCSS and some Netlify goodies
https://github.com/philhawksworth/eleventail

Last synced: 23 days ago
JSON representation

A running start for JAMstack projects with Eleventy, TailwindCSS and some Netlify goodies

• Host: GitHub
• URL: https://github.com/philhawksworth/eleventail
• Owner: philhawksworth
• Created: 2020-01-01T12:55:05.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-09T22:35:05.000Z (almost 2 years ago)
• Last Synced: 2024-08-05T09:13:48.386Z (3 months ago)
• Language: HTML
• Homepage: https://eleventail.netlify.com/
• Size: 1 MB
• Stars: 191
• Watchers: 4
• Forks: 27
• Open Issues: 16
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ElevenTail

A project scaffold for quickly starting a site build with:

- [Eleventy](https://11ty.dev) for templates and site generation

- [Tailwindcss](https://tailwindcss.com) for a utility first CSS workflow

- [PurgeCSS](https://www.purgecss.com/) for optimizing CSS output

- [UglifyJS](https://www.npmjs.com/package/uglify-js) for a simple JS build pipeline

- [Netlify CLI](https://www.npmjs.com/package/netlify-cli) for Netlify dev pipeline and local replication of prod environment

![Deploy to Netlify](eleventail-screenshot.jpg)

## Example

[![Netlify Status](https://api.netlify.com/api/v1/badges/4151ca40-1788-4959-9367-38ad71d11492/deploy-status)](https://app.netlify.com/sites/eleventail/deploys)

https://eleventail.netlify.com

## Prerequisites

- [Node and NPM](https://nodejs.org/)

- [Netlify CLI](https://www.npmjs.com/package/netlify-cli)

## Running locally

```bash

# install Netlify CLI globally

npm install netlify-cli -g

# install the project dependencies

npm install

# run the build and server locally

netlify dev

```

## Previewing the production build

When building for production, an extra build step will strip out all CSS classes not used in the site. This step is not performed during the automatic rebuilds which take place during dev.

```bash

# run the production build

npm run build

```

## Styling with TailwindCSS

This site uses TailwindCSS to offer utility CSS classes and provide a rapid means to styling the site. This means that most styling can be done without writing any additional CSS. Instead, utility classes can be added directly to the HTML. This may not be to everyone's tastes, but it can provide some very rapid development and also offer surprising levels of familiarity for those used to working in this way (since the conventions and classes are not _per site_.)

While running/developing locally, the `npm run start` command will recompile the site as files are saved and this includes the CSS pipeline from Tailwind.

### Global CSS utilities.

A small number of bespoke CSS rules are provided for efficiency of repeated or global classes. These reside in `src/site/_includes/css/tailwind.css`

## Just clone and go

You can also get started with your own copy of this site cloned to your GitHub account and deployed to [Netlify](http://netlify.com/?utm_source=github&utm_medium=eleventail-pnh&utm_campaign=devex) with a configured CI/CD pipeline and HTTPS by clicking the button below and following the instructions.

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/philhawksworth/eleventail)