spekulatius / BrowserExtension.dev

Public repo for BrowserExtension.dev. Based on Eleventail by Phil Hawksworth

BrowserExtension.dev

A website around development and more of web-/browser extensions.

Build on

Website based Eleventail by Phil Hawksworth. It uses:

• Eleventy for templates and site generation
• Tailwindcss for a utility first CSS workflow
• PurgeCSS for optimizing CSS output
• UglifyJS for a simple JS build pipeline
• Netlify CLI for Netlify dev pipeline and local replication of prod environment

Example

https://browserextension.dev

Prerequisites

• Node and NPM
• Netlify CLI

Running locally

# 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.

# 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