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.
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.
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
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.
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.
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.
This project is licensed under the ISC license. See the LICENSE file for more details.