Black Lives Matter. Support the Equal Justice Initiative and read our statement here.
Local by Flywheel

Local by Flywheel

The #1 local WordPress development tool.

Local component library

npm version

Welcome to the official component library for Local!

What's included in this component library?

We appreciate curious minds and that's a great question! Take a quick look at our living component documentation here.

In additional to a quickly growing set of React components, we also having SVGs, SASS partials, and more to come!

Quick start

  1. Clone and pull down the latest
  2. Install using yarn
  3. Start up Styleguidist yarn start
  4. Check it out at http://localhost:6060

Digging deeper

The local-components library can be broken down into 3 main parts:

  1. Components
  2. Styles
  3. SVGs


These are the visual elements that make up both Local and its Add-ons. There are currently 40+ React components in the library. Each component consists of a .tsx, index.js, and optional .sass file.

Try it out for yourself!

  1. Make changes to the internals of a component through its .tsx and .sass files (they should live reload)
  2. Play around with the examples found in the files
  3. Have an idea or bug fix? Submit a pull request.


The component library leverages CSS Modules to manage and scope styles. These are considered local styles (not to be confused with the Local app 😉) Scoped local styles are a beautiful thing that allow Local to isolate components, run Add-ons with multiple versions of local-components and avoid collisions.

As wonderful as local styles are, there are instances where CSS needs to transcend a component. For that, we make use of global styles. Global styles should be familiar to most as that's all the web had for 20+ years. These styles are intended to be used sparingly as they introduce a lot of challenges when scaling an app with a library of Add-ons and Environments.

The following is an instance where a scoped component may use a combination of local and global styles to achieve a specific result:

:global(.WindowsToolbar .DragRegion)

This is something we try to avoid and are actively working to whittle down to the bare essentials.

If you'd like to learn more about scoped styles, please check out CSS Modules here.


Coming soon!



Create local WordPress sites with hassle-free SSL Create local WordPress sites with hassle-free SSL
Go deeper with developer tools Go deeper with developer tools

Something missing? Edit this app.

Keyboard Shortcuts

Key Action
/ Focus the search bar
Esc Focus the search bar and cleans it
Select the next search result
Select the previous search result
Enter Open the selected search result
cmdEnter Ctrl+Enter Open the selected search result in a new tab