Expensify

New Expensify is developed in the open, and this repository is the entire client application. A single React Native codebase serves the web build, the iOS and Android apps and a hybrid variant, so a contributor works in one place regardless of which platform a change lands on.

Getting set up is short. Node and npm come through nvm, with strict versions pinned in the package manifest and an .nvmrc file so builds stay consistent, watchman is installed alongside them, and an install followed by a platform script starts the app. Any editor or IDE works.

The repository is organized around what a contributor needs to find.

• Platform guides: separate setup instructions for web, iOS and Android development.
• Environment variables: documented flags for API URLs, Pusher keys, ngrok tunneling and proxying around CORS errors, none of them required.
• Unit tests: Jest for components, plus Bun tests covering the server and the scripts and workflow tooling.
• Performance tests: Reassure watching for regressions, with deeper metric capture behind opt-in flags.
• Contributing docs: application philosophies, API details, a code of conduct and a contributor license agreement.

Troubleshooting notes cover the two mistakes newcomers make most, a stray environment file causing CORS failures in the browser and a Node version that does not match the pinned one. Coverage is tracked with CodeCov, and external contributors are advised against creating an environment file at all.