https://github.com/bntzio/gatsby-theme-superstylin

💅 A Gatsby Theme with styled-components
https://github.com/bntzio/gatsby-theme-superstylin

blog css-in-js gatsby gatsby-theme hacktoberfest landing-page react static-site styled-components

Last synced: about 1 month ago
JSON representation

💅 A Gatsby Theme with styled-components

• Host: GitHub
• URL: https://github.com/bntzio/gatsby-theme-superstylin
• Owner: bntzio
• Created: 2017-03-30T02:27:00.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-11T19:39:29.000Z (about 2 years ago)
• Last Synced: 2024-12-24T07:56:10.014Z (about 1 month ago)
• Topics: blog, css-in-js, gatsby, gatsby-theme, hacktoberfest, landing-page, react, static-site, styled-components
• Language: JavaScript
• Homepage: https://superstylin.netlify.com/
• Size: 4.12 MB
• Stars: 170
• Watchers: 4
• Forks: 19
• Open Issues: 52
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
Superstylin Theme 🎉😲


A Gatsby Theme with Style 💅


## What is Superstylin?

Superstylin' is a [Gatsby Theme](https://www.gatsbyjs.org/docs/themes/) that uses [styled-components](https://styled-components.com/) as the main way to style your Gatsby site, it provides an easy to start structure to get you up and running with your first Gatsby-powered site.

## About styled-components

Simply put, styled-components is a way to add your css in your js, it works by creating a component and style it, then you'll get a styled-component, it's really simple and very powerful.

## Benefits of using styled-components

By using your css in your js you get the power of javascript to add more functionality to the way you declare your styles, but wait, that's not all!

Below are some interesting readings to further discover the benefits of styled-components.

* [Styled-Components: Enforcing Best Practices In Component-Based Systems](https://www.smashingmagazine.com/2017/01/styled-components-enforcing-best-practices-component-based-systems/)

* [The magic behind 💅 styled-components](http://mxstbr.blog/2016/11/styled-components-magic-explained/)

A big thanks to [Glen Maddern](https://twitter.com/glenmaddern) and [Max Stoiber](https://twitter.com/mxstbr) for making [styled-components](https://github.com/styled-components/styled-components) 👏🎉.

Also big thanks to [Kyle Mathews](https://github.com/KyleAMathews) for starting and maintaining [Gatsby](https://github.com/gatsbyjs/gatsby) 👏🎊.

## Inline-styles vs CSS in JS

Read this excellent post on [why inline-styles !== css-in-js](http://mxstbr.blog/2016/11/inline-styles-vs-css-in-js/) by [Max Stoiber](https://github.com/mxstbr).

## Features of Superstylin 💖

* Use css-in-js with the magic of [styled-components](https://github.com/styled-components/styled-components) 💅

* Uses [Gatsby](https://www.gatsbyjs.org) built-in [GraphQL](http://graphql.org) to fetch and sort blog posts

* Easy to customize and to get started with your own Gatsby site

* Perfect for sites, blogs or both

* Super simple project structure to get you up and running fast

## Installing

Inside your starter:

```sh

$ yarn add gatsby-theme-superstylin

```

And finally, add the theme in your `gatsby-config.js`:

```js

module.exports = {

  plugins: ['gatsby-theme-superstylin']

}

```

[See the demo](https://github.com/bntzio/gatsby-theme-superstylin/tree/master/demo) for an example.

## License

Licensed under the MIT License, Copyright © 2018 Enrique Benitez

See [license](https://github.com/bntzio/gatsby-theme-superstylin/blob/master/license) for more information.