MCPcopy Create free account
hub / github.com/reach/reach-ui

github.com/reach/reach-ui @v0.18.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.18.0 ↗ · + Follow
1,052 symbols 2,875 edges 330 files ⚖ MIT 87 documented · 8% 32 cross-repo links ● updated 21mo agov0.18.0 · 2022-10-13★ 5,96389 open issues

Browse by type

⨍ Functions 922◇ Types & classes 130
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Welcome to Reach UI Development ♿️

Thanks for getting involved with Reach UI development!

Looking for the documentation?

https://reach.tech/

Getting Started

Reach UI is built and tested with Yarn. Please follow their install instructions to get Yarn installed on your system.

Then, run these commands:

git clone git@github.com:reach/reach-ui.git
cd reach-ui
pnpm install
pnpm build

Root Repo Scripts:

pnpm build        # builds all packages
pnpm dev        # starts storybook server
pnpm test         # runs tests in all packages

Running / Writing Examples

First do the steps in "Getting started", then start the Storybook server:

pnpm dev

Next, put a file in packages/<component-dir>/examples/<name>.example.js and make it look like this:

import * as React from "react";

// The name of the example (always name the variable `name`)
let name = "Basic";

// The example to render (always name the function `Example`)
function Example() {
    return 

Cool cool cool

;
}

// Assign the name to the example and then export it as a named constant
Example.storyName = name;
export const Basic = Example;

// Default export an object with the title matching the name of the Reach package
export default { title: "Dialog" };

Now you can edit the files in packages/* and storybook will automatically reload your changes.

Note: If you change an internal dependency you will need to run yarn build again. For example, if working on MenuButton requires a change to Rect (an internal dependency of MenuButton), you will need to run yarn build for the changes to Rect to show up in your MenuButton example.

Running / Writing Tests

First do the steps in "Getting Started", then:

pnpm test

Or if you want to run the tests as you edit files:

pnpm test --watch

Often you'll want to just test the component you're working on:

cd packages/<component-path>
pnpm test --watch

Development Plans

The components to be built come from the the Aria Practices Design Patterns and Widgets, with a few exceptions. Here is a table of the components and their status.

✅ - Released

🛠 - Building

Status Name
✅ Accordion
✅ Alert
✅ Alert Dialog
✅ Checkbox
✅ Combo Box
✅ Dialog (Modal)
✅ Disclosure
🛠 Hover Card
✅ Listbox
✅ Menu Button
🛠 Radio Group
✅ Slider
✅ Tabs
🛠 Toggletip
✅ Tooltip

Releases [DEPRECATED]

This is (was?) our current release process. It's not perfect, but it has almost the right balance of manual + automation for me. We might be able to put some of this in a script...

$ git checkout main
$ git pull origin main
$ git checkout dev
$ git pull origin dev
$ git checkout -b release-<version>
$ git merge main

# Resolve any merge conflicts and commit if necessary

# Run the build locally and make sure there are no problems
$ pnpm build
$ pnpm test

# Check out the `main` branch and merge release changes from `dev`
$ git checkout main
$ git pull origin main
$ git merge dev

# Write the changelog based on commits. We'll automate this part
# eventually, but for now this is manual.

# Then create a new version and git tag locally. Don't push yet!
$ pnpm ver [version]

# Take a look around and make sure everything is as you'd expect.
# You can inspect everything from the commit that lerna made with:
$ git log -p

# If something needs to be changed, you can undo the commit and
# delete the tag that lerna created and try again.

# If everything looks good, push to GitHub along with the new tag:
$ git push origin main --follow-tags

# Open up https://github.com/reach/reach-ui/actions and watch the build. There will
# be 2 builds, one for the push to the main branch and one for the
# new tag. The tag build will run the build and all the tests and then
# automatically publish to npm if everything passes. If there's a
# problem, we have to figure out how to fix manually.

# Paste the changelog into the release on GitHub. The release is
# complete … huzzah!

You need to be careful when publishing a new package because the lerna publish on CI will fail for new packages. To get around this, you should publish a 0.0.0 version of the package manually ahead of time. Then the release from CI will be ok. This is really janky but AFAICT the only workaround.

Stuff I'd like to improve:

  • Automate changelog generation and GitHub release from CI
  • Document how we're using GitHub PRs to generate the changelog somewhere

Website

The website is a Gatsby app in the website directory. It automatically deploys to https://reach.tech/ when the website branch is updated.

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 880
Interface 116
Method 42
Enum 13
Class 1

Languages

TypeScript100%

Modules by API surface

website/static/router/static/js/vendors~app~vendor.4982872f.chunk.js241 symbols
website/static/router/static/js/vendors~app.6755dc85.chunk.js57 symbols
packages/combobox/src/reach-combobox.tsx35 symbols
packages/tooltip/src/reach-tooltip.tsx32 symbols
packages/dropdown/src/reach-dropdown.tsx31 symbols
packages/slider/src/reach-slider.tsx30 symbols
packages/listbox/src/reach-listbox.tsx28 symbols
playground/stories/slider/utils.ts27 symbols
packages/popover/src/reach-popover.tsx22 symbols
packages/checkbox/src/mixed.tsx20 symbols
website/static/router/static/js/app.f4d1301c.js18 symbols
packages/listbox/src/machine.ts18 symbols

Dependencies from manifests, versioned

@babel/core7.18.6 · 1×
@babel/preset-env7.18.6 · 1×
@babel/preset-react7.18.6 · 1×
@babel/preset-typescript7.18.6 · 1×
@changesets/cli2.25.0 · 1×
@mdx-js/mdx1.6.22 · 1×
@mdx-js/react1.6.22 · 1×
@philpl/buble0.19.7 · 1×
@reach-internal/devworkspace:* · 1×
@reach-internal/testworkspace:* · 1×
@reach-internal/tsconfigworkspace:* · 1×
@reach/accordionworkspace:* · 1×

For agents

$ claude mcp add reach-ui \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page