Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 days 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 (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-25T14:40:06.000Z (19 days ago)
- Last Synced: 2024-10-26T18:10:31.517Z (18 days ago)
- Language: TypeScript
- Homepage:
- Size: 863 KB
- Stars: 126
- Watchers: 2
- Forks: 3
- Open Issues: 7
-
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