Repository navigation
Community Rule Toolkit
The OpenBridge Rule Toolkit lets people who know benefits policy or law check and improve OpenBridge's rules without writing code. It is one file you download and open in your web browser. Nothing you type is sent anywhere.
The rules in OpenBridge are drafts that experts are still checking. Your review is part of that checking. Only a subject-matter expert sign-off can mark a state's rules as verified.
-
Go to the OpenBridge repository's Releases page and download
openbridge-rule-toolkit-v<version>.zipfrom the newest release. If there is no release yet, a developer can build it withnpm run buildand find it atpackages/rule-toolkit/dist/. -
Unzip the folder and double-click OpenBridge-Rule-Toolkit.html. It opens in your browser and works without the internet. If it opens in the wrong program, right-click it, choose Open with, and pick Chrome, Edge, Firefox, or Safari.
-
The home page lists three tools. Choose Open next to the one you need.

Use this to check a whole state against its official sources in one sitting.
-
Choose Review a state's rules, then pick a state.
-
Each rule value is shown in plain words, under What the rules say, for example "130% of the poverty line" or "$2,750.00". Under Source you see the official source and the date it was published, or No source listed yet.
-
For each value, answer Does it match the source? with Matches the source, Does not match, or Not sure. Add a note if it helps, for example the page number.
-
Watch the count at the top (for example "7 of 15 checked").
-
Under About you (optional) you can add your name and role. These go only into the report you download.
-
Choose Download report to save a report file, or Copy report text to paste it somewhere.

"No source listed yet" is not an error in your review. It tells us which values still need a citation, and finding one is a great contribution.
Use this when a value is wrong or out of date and you have the official source that shows the right one.
-
Choose Propose a rule change, then pick a state, a Program, and a Rule value. You see What the rules say now and the Source now.
-
Enter the New value: a percent of the poverty line, a dollar amount, or yes or no. Some values can be Not used when that test does not apply in the state.
-
If the same source shows more than one change, choose Add another change from the same source. For a different source, make a second proposal.
-
Under Official source, enter its name, its web address (starting with
https://), and the date printed on it. -
Under Why should this change?, say in your own words where the number is in the source.
-
Choose Check my proposal. Fix anything marked in red. When it says Your proposal is ready, choose Download proposal file and Copy issue text.

Use this to see whether the current rules give the results a test case expects, for example one someone made with Record a test case or one already in the project.
-
Choose Check a test case, then choose the test case file (it ends in
.json). -
You see each program, and each person where it applies, with what the test case expects, what the rules give, and Pass or Mismatch.
-
Open Why and the math to see the reasons and the numbers behind each result.

Test cases are checked as if today were June 1, 2024, the same date the project's own checks use, so results match what reviewers see in the repository.
Attach the file you downloaded to a new issue using the Eligibility rule correction form (see Report a rule problem), or email it to openbridge@starlingtek.com. For a proposal, paste the copied issue text into the issue too.
What happens next: a maintainer applies your proposal with one command
(npm run rules:apply -- proposal.json), which records your source as the citation and keeps the
state marked draft. The change then goes through review like any other, and an expert checks it
before a state can be marked verified.
- The toolkit makes no network connections and saves nothing in the browser. Your work leaves your computer only as a file you choose to download.
- Use made-up households for test cases, never a real person's details.
- The toolkit carries the rules from the release you downloaded. Download a newer release to review newer rules.
- It covers state rule values today. Federal figures (the poverty line and SNAP amounts) are updated by maintainers; see Yearly data updates.
- The toolkit is in English for now.
OpenBridge is a prototype. Its rules are drafts that experts have not verified yet, and results are
estimates, not decisions. It is not legal advice. Need help applying for benefits? Call 211 or visit
211.org. This wiki is edited in the wiki/ folder of the repository.
Questions: openbridge@starlingtek.com.
Start here
Use OpenBridge
- Using OpenBridge
- Understanding your results
- Guide for navigators
- Privacy and your data
- Run it on your computer
- Host it for others
- Use it with an AI assistant
Help without code
- Ways to help
- Review rules as an expert
- Record a test case
- Report a rule problem
- Translate OpenBridge
- Test accessibility
- Community rule toolkit
Rules and policy (with code)
- How the rules engine works
- State adapters
- Add or change a rule
- Add a new state
- Golden test cases
- Yearly data updates
Developers