Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/carbon-design-system/gatsby-starter-carbon-theme

A Gatsby starter demonstrating the Gatsby Carbon theme
https://github.com/carbon-design-system/gatsby-starter-carbon-theme

Last synced: 4 months ago
JSON representation

A Gatsby starter demonstrating the Gatsby Carbon theme

Awesome Lists containing this project

README

        

# Gatsby Theme Carbon Starter

## What is this?

> Gatsby [themes](https://www.gatsbyjs.org/docs/themes/) encapsulate all of the
> configuration and implementation details of Gatsby websites. This is a
> starter-kit (boilerplate) with a dependancy on the `gatsby-theme-carbon`
> package. The primary goal of `gatsby-theme-carbon` is to get content authors
> speaking the IBM Design Language with Carbon as soon as possible. It includes
> some sample components/content demos in the `src/pages` directory.

## How do I use it?

Check out our quick
[getting started](https://gatsby-theme-carbon.now.sh/getting-started) guide and
video!

`gatsby-theme-carbon` at it’s core relies on [mdx](https://mdxjs.com/) for page
creation. Check out the `src/pages` directory for some examples for using mdx.

A key feature of Gatsby themes is component shadowing. By simply placing a
component into the `src/gatsby-theme-carbon/components` location, you can
override components used by the theme. You can read more about component
shadowing
[here](https://www.gatsbyjs.org/docs/themes/api-reference#component-shadowing).

You’re also free to make your own components and use them in your MDX pages.

## What’s Next?

[Check out the docs!](https://gatsby-theme-carbon.now.sh)