Skip to content
/ pears Public

🍐️ A starter kit for building static sites quickly, easily, and efficiently.

License

Notifications You must be signed in to change notification settings

bradp/pears

Repository files navigation

🍐️  Pears - A Static Site Starter Kit

illustration of pears

A starter kit for building static sites quickly, easily, and efficiently.

Build Status Latest Release Last commit

View live demo →

⚠️ Currently, Pears is in an early state of development. Things may break & change.

🏆 Goals

  • Super simple to use and develop with. No messing with settings and configurations.
  • Easy to use for those who are not familiar with Hugo. They shouldn't have to learn more than the basics.
  • Powered by tools that are focused on a quick and efficient development cycle.
  • Pre-packed with shortcodes & partials for a ton of different components.

🎉️ What's included?

🚧   Hugo - The fastest framework for building static sites

🎨   TailwindCSS, Tailwind Forms, and Tailwind Typography Utility-first CSS framework to build your site without ever having to leave your HTML.

🔧️   PostCSS, autoprefixer, and PurgeCSS Trim your CSS files (including Tailwind's) to be only the classes and rules you actually use in your markup.

🌈️   Prettier and stylelint Write better code without having to think about formatting.

🔍️   ESLint Never run into JS errors again.

🚀️ Getting Started

Getting set up for using this project requires install a few different things. Don't worry, it's easy.

Requirements

You will need to install Hugo if you don't already have it. There are pre-built binary files available for almost every platform.

Installing

Once you have Yarn and Hugo installed on your system, all you need to do is grab a copy of Pears and install the dependencies.

git clone https://github.com/bradp/pears <your-new-site-name>
cd <your-new-site-name>
npm i

⚡️ Usage

  • To start up your local development environment: npm start
  • To see a full list of available commands: npm run

Main Commands

Command Action
npm start Builds all files & starts up the development server
npm build Builds all files for a local or staging environment
npm build:prod Builds all files for a deployment to a production server
npm lint Check your CSS & JS files for errors Append :fix to automatically fix
npm format Fix formatting errors automatically

Building & Linting

Command Action
npm lint:css Lint CSS files Append :fix to automatically fix
npm lint:js Lint JS files. Append :fix to automatically fix
npm format:check Check formatting errors without automatically fixing

Remember, you can always check yarn run to see full list of commands!

🔮️ Roadmap

See the open issues for a list of proposed features (and known issues).

📕️ License

Distributed under the MIT License. See LICENSE for more information.