|
4 | 4 | </picture> |
5 | 5 | </a> |
6 | 6 | <p align="center"> |
7 | | - 🪨 Rock is a cross-platform React Native app development and build toolchain built for modularity, build reuse, and incremental adoption. It integrates seamlessly with your existing infrastructure, giving you complete control without vendor lock-in. |
| 7 | + 🪨 Rock is a modular toolkit for teams building React Native apps. It helps improve build times and developer experience while fitting into your existing workflows and infrastructure. |
8 | 8 | </p> |
9 | 9 |
|
10 | 10 | --- |
11 | 11 |
|
12 | | -## React Native at scale is challenging |
| 12 | +## Key Features |
13 | 13 |
|
14 | | -Enterprise apps aren't built overnight. As maintainers of the Community CLI and partners to enterprise teams, we've seen the real challenges: high build times, difficulty adopting new third-party cloud services, and high barriers to introducing React Native into existing iOS and Android apps. |
| 14 | +**☁️ Remote Build Cache** |
| 15 | +Save up to 96% of build time by reusing native artifacts (APK, AAB, APP, IPA) across machines and CI. Use built‑in integrations for GitHub, S3, and R2 or bring your own storage. |
15 | 16 |
|
16 | | -Rock simplifies native build setup and reuse. In most React Native codebases, only about 10% of code changes affect the native iOS/Android files. Yet most teams rebuild their native apps constantly—on every commit, PR, or merge to main—when it's completely unnecessary. |
| 17 | +**🔗 Brownfield ready** |
| 18 | +Add React Native to existing iOS and Android apps using Rock Brownfield. |
17 | 19 |
|
18 | | -Rock leverages this insight by providing intelligent caching in your cloud infrastructure, seamlessly integrated through its CLI. This allows you to skip up to 90% of unnecessary native builds. |
| 20 | +**🔌 Modular & Extensible** |
| 21 | +A plugin‑driven architecture that lets you customize platforms, bundlers, cache providers, and more. |
19 | 22 |
|
20 | | -## Features |
| 23 | +**🖥️ Cross‑platform‑ready** |
| 24 | +iOS and Android by default; designed to extend to TVs, macOS, and Windows (coming soon). |
21 | 25 |
|
22 | | -**🖥️ Brand New CLI** |
23 | | -A familiar CLI experience with end-to-end development and build workflows. Migrate in seconds with `npm create rock`. |
24 | | - |
25 | | -**☁️ Reusable Cloud Builds** |
26 | | -Reliable caching of native artifacts (APK, IPA) that you can store wherever you prefer, or use our out-of-the-box integrations with GitHub, S3, and R2. |
27 | | - |
28 | | -**🔧 GitHub Actions** |
29 | | -Complete logic for downloading, uploading, and building native artifacts for iOS (APP, IPA) and Android (APK, AAB). |
30 | | - |
31 | | -**🔗 Plug-and-Play Brownfield** |
32 | | -Package your React Native app as a framework and integrate it into your iOS and Android apps just like any other library. |
33 | | - |
34 | | -**📦 Bundler Flexibility** |
35 | | -Rock supports both Metro and Re.Pack for JavaScript bundling. With Re.Pack, you can build Super Apps and Mobile Microfrontends. |
36 | | - |
37 | | -**🔌 Extensible Plugin System** |
38 | | -Built with modularity in mind, Rock allows you to extend its capabilities through plugins that integrate with both the CLI and native templates. |
| 26 | +**⚡ Easy Community CLI Migration** |
| 27 | +A familiar CLI that helps you develop, run, and build your app. Migrate from Community CLI in minutes. |
39 | 28 |
|
40 | 29 | ## Installation |
41 | 30 |
|
42 | | -Rock is designed for incremental adoption. Whether you're just starting with React Native in your iOS or Android app, or want to migrate from the React Native Community CLI, you can do it step-by-step without having to figure everything out at once. |
| 31 | +Choose your path based on your current situation: |
43 | 32 |
|
44 | | -### Migrating an existing Community CLI project |
| 33 | +### Creating a new project |
45 | 34 |
|
46 | | -To migrate an existing project, open a terminal in your project root and run: |
| 35 | +> **Consider Expo First** |
| 36 | +> For **new projects**, we recommend starting with [Expo](https://expo.dev) for the best developer experience and similar remote caching capabilities. Rock is designed for teams who have outgrown the Community CLI. |
| 37 | +
|
| 38 | +To create a fresh React Native app with Rock, open a terminal and run: |
47 | 39 |
|
48 | 40 | ```shell |
49 | 41 | npm create rock |
50 | 42 | ``` |
51 | 43 |
|
52 | | -### Creating a new project |
| 44 | +### Migrating an existing Community CLI project |
53 | 45 |
|
54 | | -To create a fresh React Native app with Rock, open a terminal and run: |
| 46 | +To migrate an existing project, open a terminal in your project root and run: |
55 | 47 |
|
56 | 48 | ```shell |
57 | 49 | npm create rock |
|
0 commit comments