https://github.com/thoughtbot/belt
Belt is a CLI for starting a new React Native Expo app and will even keep your pants secure as you continue development.
https://github.com/thoughtbot/belt
Last synced: about 1 year ago
JSON representation
Belt is a CLI for starting a new React Native Expo app and will even keep your pants secure as you continue development.
- Host: GitHub
- URL: https://github.com/thoughtbot/belt
- Owner: thoughtbot
- License: mit
- Created: 2023-05-03T21:51:25.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-12T20:25:44.000Z (over 1 year ago)
- Last Synced: 2025-04-04T05:06:55.317Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 869 KB
- Stars: 132
- Watchers: 2
- Forks: 3
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Belt
_While we actively use Belt internally at thoughtbot, this project is still in early phases of development, so its API might still change frequently._
Belt is an opionated CLI tool for starting a new React Native app. It makes the mundane decisions for you using tooling and conventions that we at thoughtbot have battle-tested and found to work well for the many successful apps we have built for clients.
Here are some of what gets configured when you start a new Belt app:
- Expo
- ESLint
- Prettier
- TypeScript
- Jest
- React Native Testing Library
- MSW for mocking
- React Navigation with bottom tabs
- Tanstack Query for REST APIs. Apollo Client for GraphQL coming soon!
- Redux Toolkit for global state (coming soon!)
## Usage
Create a new React Native Expo app using Belt with:
```sh
# With NPM
npx create-belt-app MyApp
# With Yarn
npx create-belt-app MyApp --yarn
# With pnpm (experimental)
npx create-belt-app MyApp --pnpm
# With Bun (experimental)
npx create-belt-app MyApp --bun
```
then run the command you'd like to perform:
```sh
# eg. add TypeScript to the project
yarn belt add notifications
# or, with NPM
npx belt add notifications
# or, with PNPM
pnpm belt add notifications
```
## Contributing
See the [CONTRIBUTING](./CONTRIBUTING.md) document. Thank you, [contributors](https://github.com/thoughtbot/belt/graphs/contributors)!
## License
Belt is Copyright © 2024 thoughtbot. It is free software, and may be
redistributed under the terms specified in the [LICENSE](/LICENSE) file.
### About thoughtbot
Belt is maintained and funded by thoughtbot, inc.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
We love open source software! See [our other projects][community] or
[hire us][hire] to design, develop, and grow your product.
[community]: https://thoughtbot.com/community?utm_source=github
[hire]: https://thoughtbot.com/hire-us?utm_source=github