futurice/pepperoni-app-kit is a Mobile project on GitHub, written primarily in JavaScript. It has 4.6k stars. Pepperoni - React Native App Starter Kit for Android and iOS
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Dear community, as time moved on so did React Native and we've not been able to provide continous support for pepperoni in the past. We are happy that so many of you found it useful and are looking forward to build new tools in the future.
If you are new to React Native and are looking for ways how to start, Expo is a great choice or head straight to the React Native docs as it's never been easier to get started with the official setup.
Intro
We :green_heart: building apps with React Native, because it helps us create high quality products for both major mobile platforms quickly and cost-effectively.
Getting started on a new app just takes too damn long, though. Most apps need the same basic building blocks and developer infrastructure, and we are bored of reinventing the wheel time and time again.
This Starter Kit reflects the best practices of React Native development we have discovered while building real-world applications for our customers. It is opinionated about tooling, patterns and development practices. It might not be a one-size-fits-all solution for everyone, but feel free to customize it for your needs, or just take inspiration from it.
React Native Starter Kit is a part of Pepperoni, a framework for kickstarting digital product development.
tltr;
Sounds good and you just want to see how it works? Here is a quick start guide:
git clone https://github.com/futurice/pepperoni-app-kit.git
cd pepperoni-app-kit
yarn install
react-native run-ios
For further setup instructions please see our Getting Started section.
Contents
:warning: WORK IN PROGRESS |
:star: COMING SOON
Not all of the below is yet fully implemented
Application Blueprint
Always up-to-date React Native scaffolding
Modular and well-documented structure for application code
Redux and ImmutableJS for safe and Reasonaboutable:tm: state management
Redux Loop for Elm-style controlled side effects
React Navigation for awesome navigation with 60fps transitions
Disk-persisted application state caching for offline support and snappy startup performance
Clean and testable service layer for interacting with RESTful APIs
:warning: Sample app to show how to wire it all together
:star: JSON Web Token authentication
:star: Multi-environment configuration (dev, staging, production) for iOS and Android
:star: Built-in error handling and customizable error screens
Testing Setup
Jest for unit testing application code and providing coverage information.
Enzyme and fully mocked React Native for unit testing UI components
Utilities for end-to-end integration testing Redux state, including side effects and asynchronous actions
Development & Deployment Infrastructure
Bitrise.io configurations for Continuous Integration and beta app distribution
:warning: Google Tag Manager analytics
Travis CI example configuration for Android, iOS and Javascript tests.
Roadmap
TODO :star: Microsoft Code Push for instant JavaScript and images update
TODO Crash reporting
TODO Android and iOS UI Testing with Calaba.sh?
TODO Feature flags?
Getting started
To build your own app on top of the Starter Kit, fork or mirror this repository. For serious use we recommend mirroring using these instructions, since you can't make a fork of a public repository private on GitHub. 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.
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.
Debugging
For standard debugging select Debug JS Remotely from the React Native Development context menu (To open the context menu, press CMD+D in iOS or D+D in Android). This will open a new Chrome tab under http://localhost:8081/debugger-ui and prints all actions to the console.
For advanced debugging under macOS we suggest using the standalone React Native Debugger, which is based on the official debugger of React Native.
It includes the React Inspector and Redux DevTools so you can inspect React views and get a detailed history of the Redux state.
You can install it via brew and run it as a standalone app:
Note: Make sure you close all active chrome debugger tabs and then restart the debugger from the React Native Development context menu.
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.
How active is development on futurice/pepperoni-app-kit?
The most recent commit recorded on futurice/pepperoni-app-kit was 3.4 years ago, based on the GitHub push timestamp. The repository has 627 forks — one of the better signals of community interest.
How many stars does futurice/pepperoni-app-kit have?
futurice/pepperoni-app-kit has 4.6k GitHub stars — refresh the page for the live number, or check github.com/futurice/pepperoni-app-kit. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is futurice/pepperoni-app-kit open source?
Yes — futurice/pepperoni-app-kit ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/futurice/pepperoni-app-kit.
What else is in the Mobile space?
futurice/pepperoni-app-kit is tracked by TopGit under the Mobile category, alongside 7 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is futurice/pepperoni-app-kit associated with?
GitHub's repository topics for futurice/pepperoni-app-kit: "futurice", "immutable", "jest", "pepperoni", "react-native", "redux", "starter-kit". TopGit's editorial category is Mobile.
Where can I see futurice/pepperoni-app-kit in action?
The project maintains a homepage at http://getpepperoni.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about futurice/pepperoni-app-kit?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/futurice/pepperoni-app-kit is the definitive source.
Read full README in the tab above.
Curious whether pepperoni-app-kit is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about pepperoni-app-kit.