Repository navigation
Using OpenBridge
This page walks you through checking which benefits you might get, one step at a time. It is for anyone looking for help for themselves or their family. You do not need to be good with computers.
OpenBridge is a prototype. The rules are drafts that experts have not checked yet. Your results are estimates, not decisions. Only the agency that runs a program can say if you qualify.
- Plan for about 15 to 30 minutes.
- Have a rough idea of how much money your household gets each month, and from where (a job, Social Security, child support, and so on). Pay stubs help, but you can guess.
- You do not need your name, Social Security number, or address. OpenBridge never asks for them.
- OpenBridge covers Ohio, Texas, and Washington for now.
-
Open OpenBridge. Open it from the web address your organization gave you, or from the file on your computer (see Run it on your computer).
-
Pick who it is for. Choose I'm checking for myself. (Choose I'm helping others (navigator) only if you screen people for work. See Guide for navigators.)

-
Pick a language if you want. The small menu at the top says EN for English and ES for Spanish. Some screens are still in English only.
-
Press Start. You will see "Step 1 of 5" at the top. A message says your information is only on this device and has not been sent anywhere.
-
Step 1, "Where do you live?" Choose your State. You can type your County. Leave I live in this state checked if it is true. Press Next.

-
Step 2, "Who is in your household?" Press Add a person for each person who lives and eats with you, starting with yourself. For each person, choose a Relationship and give a Date of birth or an Age. Check any boxes that fit, like Pregnant or Has a disability. Immigration status is optional. Leaving it blank is fine, and status alone never makes OpenBridge say "no". Press Next.

-
Step 3, "What income does your household have?" Press Add income for each kind of money coming in. Choose the Type, type the Amount (before taxes), and choose How often? If you are paid by the hour, also fill in Hours per week. If no one has income, skip this step. Press Next.

-
Step 4, "A few optional details". You can add rent, utilities, savings, and whether you already get SNAP, Medicaid, or cash assistance. These are optional, but they can make your results more exact. Press Next.

-
Step 5, "Review". Check the count of people and incomes. Press Back to fix anything. Then press See my results.
Money boxes accept amounts like 1250, 1,250, or $1,250.50.
Some menus still show short codes instead of full words. Here is what they mean.
| You see | It means |
|---|---|
self |
You |
other_relative |
Other family |
non_relative |
Someone who is not family |
biweekly |
Every two weeks |
semimonthly |
Twice a month |
lpr_5yr_plus |
Green card holder for 5 years or more |
lpr_under_5yr |
Green card holder for less than 5 years |
prefer_not_to_say |
You would rather not say (always fine) |
The Your results page lists each program with a short answer, like "You may well qualify", and the reasons. Press a program's name to see more: the numbers, Show the math, next steps, and the documents you will likely need. To learn what each answer means, read Understanding your results.

From the results page you can also:
- Press What if my income changes? to see how a raise or fewer hours might change things.
- Under Your documents, press Download summary sheet (PDF) to keep a copy of your results.
- Press Get help for organizations that can help you apply.
Your answers disappear when you close the page. To keep them:
-
On the results page, open Save my progress to a file.
-
Type a passphrase (a secret phrase) in Passphrase (at least 6 characters).
-
Press Download saved file. Your browser saves a file named
openbridge-progress.json.
Write your passphrase down somewhere safe. If you forget it, no one can open the file, not even the OpenBridge team.
To come back later, open OpenBridge, press I have a saved file, choose the file in Saved file, type your Passphrase, and press Unlock and continue. Your answers fill back in at Step 1. Press Next through the steps and See my results again.

Press Clear my data / Start over at the top of any page. It erases your answers and results and takes you back to the start. Do this every time on a shared or library computer.
If you step away, OpenBridge clears itself. After a while with no activity, it asks "Are you still there?" Press I'm still here to keep going. If you do not, it clears everything about 30 seconds later. (By default this happens after 3 minutes of no activity.)
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: [email protected].
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