NOTE: This project is not officially associated with Semantic UI, Facebook and/or Gatsby in any way. It is just a helpful boilerplate arranged by me.

Introduction

This is a boilerplate project that intends to provide an easy way to setup Gatsby with a customizable version of Semantic UI, as this process is usually clumsy and full of little inconveniences.

It is based on the Webpack 3 example provided by the Semantic UI folks, with a bunch of opinionated changes.

How to use

Installation

NOTE: This starter is intended for use with Gatsby 2.0.0 and above.

Make sure that you have the Gatsby CLI program installed
yarn global add gatsby-cli@next (npm: npm install --global gatsby-cli@next)

Now run from your terminal
gatsby new my-project https://github.com/pretzelhands/gatsby-starter-semantic-ui

Then you can run it by doing the following

cd my-project
gatsby develop

Gatsby will start up a web server for you and you are ready to go.

If you've never worked with Gatsby before, I recommend reading the documentation

Customizing Semantic UI

To customize Semantic UI you can find the appropriate files in src/semantic/site. To understand the file structure provided in that folder, please read the Customization Guide provided by Semantic UI.

The theme files are pre-filled with all available variables so you can just set them and forget them. As you save those files Gatsby will automatically re-compile your files.

Contributing

Contributions in any form are welcome! If you find a bug, please file an issue. All contributors are asked to abide by the rules of the Contributor Covenant.

Updates

This repo will be kept up-to-date in accordance with the stable releases of React, Gatsby, Semantic UI and Semantic UI React insofar they are compatible.

If major changes happen to the Webpack 3 example of the Semantic UI React repository, I will reflect them in this repository.

License

This project is licensed under the ISC license. See the LICENSE file for more details.