styled-components.com

The styled-components website. Built with Next.js, Preact and (of course) styled-components!

Contributing

Thank you so much for wanting to contribute to the website! We could really use a hand at making it the best it can be, see the issues for some ideas on what to do.

If you've never worked with the technologies used in this repo, here are some links that may help:

• Learn Next.js
• Next.js documentation
• react-markings documentation
• styled-components documentation (this very website!)

Running locally

To develop the website locally, you'll want to run the development server:

# Download the repo
git clone https://github.com/styled-components/styled-components-website
# Enter the repo
cd styled-components-website
# Install the dependencies
npm install
# Start local development
npm run dev

Note: This requires Node.js and npm to be set up locally, see nodejs.org for more information.

Updating the visual diffs

If you add a new section or materially change the website, it probably will trigger the image comparison diff snapshot to fail. These can be updated via:

yarn integration -u

Folder structure

This is what each folder correlates to:

styled-components-website
├── components/  # Shared components
├── pages/       # The actual pages, mostly containing layout; the directory directly correlates to the URL. (e.g. pages/docs/basics.js === styled-components.com/docs/basics)
├── sections/    # The content, written in Markdown
├── static/      # Assets
├── test/        # Tests
├── utils/       # Various utilities use across the site
└── vendor/      # Cached dependencies

Got stuck?

Feel free to ping us on Spectrum if you get stuck somewhere while trying to make this website better, let's resolve it together!