@stackoverflow/stacks

Stacks

You’re looking at Stack Overflow’s CSS and Design Pattern Library. This library is in its early stages, but will eventually replace Stack Overflow’s CSS as we near our version 1. To see our progress and milestones, check out our ongoing projects.

Contributing

Stacks is built using Jekyll and Grunt. The source files at this repo get mirrored and served from GitHub pages at a private Repo on GitHub.com. Once changes are committed, approved, and merged into master here, the changes are synced to our private repo and automatically rebuilt. The website can be viewed at https://stackoverflow.design

To contribute, clone this repository and create a new branch. Open a pull request with your rationale and the team will review your code. Feel free to open pull requests way earlier than you feel comfortable. :sunglasses:

Running Stacks

Open this repo in your Terminal and type:

grunt

This will start your Jekyll server and watch for any changes you make. You can now visit the site locally at http://127.0.0.1:4000/

You’ve got errors, you likely need to install Jekyll or Grunt.

Installing Jekyll

To get started with running Jekyll locally, follow the "Getting Started" instructions from the Design/SiteStarterPack repo.

Installing Grunt

To use Grunt, you’ll first need to install Node & NPM. Then, install Grunt globally on your machine. Once both are installed, open this repo’s directory in your Terminal. Within this repo’s folder, type npm install. This will download all the dependencies to a directory called node_modules. Now you can type grunt into the Terminal and it’ll compile the Less, minify CSS, and serve the site locally. 😎

Help

If you get stuck, visit Jekyll's documentation site. If you still don't find what you're looking for, you can either create an issue or pop into the #design-stacks Slack Channel to ask your question.