Always up-to-date React Native scaffolding
Modular and well-documented structure for application code
Redux and ImmutableJS for safe and Reasonaboutable™️ state management
Redux Loop for Elm-style controlled side effects
Redux-managed Navigators for Stack-based and Tabbed navigation with NavigationExperimental
Disk-persisted application state caching for offline support and snappy startup performance
Clean and testable service layer for interacting with RESTful APIs
⚠️ Sample app to show how to wire it all together
⭐ JSON Web Token authentication
⭐ Multi-environment configuration (dev, staging, production) for iOS and Android
⭐ Built-in error handling and customizable error screens
总是最新的本地脚手架的反应。
为应用程序代码模块化和证据确凿的结构。
回来的,ImmutableJS安全和Reasonaboutable™️状态管理。
控制回路为Elm-style回来的副作用。
Redux-managed航海家与NavigationExperimental基于堆栈和选项卡导航。
Disk-persisted应用程序状态为离线缓存支持和时髦的启动性能。
清洁和可测试的服务层与RESTful api进行交互。
⚠️示例应用程序展示了如何连接在一起。
⭐JSON Web令牌认证。
⭐试件进行配置(dev、分期、生产)为iOS和Android。
⭐内置的错误处理和可定制的错误屏幕。
Testing Setup.
Mocha for unit testing application code.
Enzyme and fully mocked React Native for unit testing UI components
Istanbul code coverage.
Utilities for end-to-end integration testing Redux state, including side effects and asynchronous actions.
测试设置。
摩卡的单元测试应用程序代码。
酶和完全嘲笑本地反应单元测试UI组件伊斯坦布尔的代码覆盖率。
公用事业的端到端集成测试回来的状态,包括副作用和异步操作。
Development & Deployment Infrastructure.
Auth0 for ready-to-use login and signup screens, user authentication and identity management.
Bitrise.io configurations for Continuous Integration and beta app distribution.
⚠️ Google Tag Manager analytics.
⭐ Microsoft Code Push for Continuous Deployment and instant app updates.
开发和部署的基础设施。
Auth0对即食登录和注册界面,用户身份验证和身份管理。
Bitrise.io配置持续集成和测试应用程序分布。
⚠️谷歌标记经理分析。
⭐微软代码推动持续部署和即时应用程序更新。
Roadmap
TODO Crash reporting
TODO Android and iOS UI Testing with Calaba.sh?
TODO Feature flags?
路线图。
TODO崩溃报告。
TODO Android和iOS和Calaba.sh UI测试吗?。
TODO特性标志?。
Getting started
To build your own app on top of the Starter Kit, fork or mirror this repository. Because you can't rename a fork, for serious use we recommend mirroring using these instructions. To contribute to Starter Kit development or just playing around, forking is the way to go.
First, give your application a name by running ./support/rename.sh YourAppName.
Once you have the code downloaded, follow the Setup guide to get started.
开始
构建您自己的应用程序上的Starter Kit,叉或者镜子这个库。
因为你不能重命名一个叉,严重使用我们推荐使用这些指令镜像。为Starter Kit开发或玩耍,分叉的路要走。
首先,给您的应用程序名称通过运行。./support/rename.sh YourAppName。
一旦你已经下载的代码,按照安装指南开始。
Development workflow
After you have set up the project using above instructions, you can use your favorite IDE or text editor to write code, and run the application from the command line. Turn on React Native hot module reloading in the app developer menu to update your application as you code.
To learn how to structure your application and use the Redux application architecture, read the Architecture guide for more details.
Start the application in iOS simulator
$ react-native run-ios
Start the application in Android simulator
(If using the stock emulator, the emulator must be running)
$ react-native run-android
Run unit tests
$ npm test
Run tests every time code changes
$ npm run test:watch
Generate code coverage report
$ npm run coverage
Read the Testing guide for more information about writing tests.
开发工作流程
设置项目后使用上面的指令,您可以使用您最喜爱的IDE或文本编辑器来编写代码,并从命令行运行应用程序。打开本地热反应模块重新加载应用开发者菜单更新您的应用程序代码。
学习如何构建您的应用程序和使用Redux应用程序架构,架构指南读更多的细节。
Deployment
Read the Deployment guide to learn how to deploy the application to test devices, app stores, and how to use Code Push to push updates to your users immediately.
部署
阅读部署指南,学习如何将应用程序部署到测试设备,应用程序商店,以及如何使用代码将立即更新你的用户。
Contributing
If you find any problems, please open an issue or submit a fix as a pull request.
We welcome new features, but for large changes let's discuss first to make sure the changes can be accepted and integrated smoothly.
贡献
如果你发现任何问题,请打开一个问题或提交修复作为拉请求。
我们欢迎新功能,但对于大型变化让我们先讨论,以确保顺利更改可以接受和集成。
License
MIT License
许可证
麻省理工学院的许可
Credits
This project was initially motivated by Snowflake, a React Native boilerplate by Barton Hammond. It shares some features and design principles for Pepperoni, but it wasn't the right fit for our needs. At this time Snowflake is more mature, so if you like Pepperoni but didn't agree with something we are doing, you should check it out to see if it's a good fit for your app.
学分
这个项目最初是出于Snowflake,巴顿哈蒙德反应本地样板。股票的一些特性和设计原则为意大利辣香肠,但它不适合我们的需要。这个时候雪花更成熟,所以如果你喜欢意大利辣香肠但不同意我们做的东西,你应该检查一下,看它是否适合你的应用程序。
