create-react-native-setup

Create React Native App — bare React Native CLI project generator & starter kit

npx create-react-native-setup MyApp

create-react-native-setup is a React Native CLI tool and bare React Native project generator. It scaffolds an Android & iOS app, installs compatible starter packages, and can configure Firebase, FCM push notifications, app icons, and splash screens—then prints a clear report of every change.

Inspired by the developer experience of tools like create-vite and create-expo-app, focused on bare React Native (Community CLI), not Expo managed workflow.

Table of contents

• Features
• Why use this package?
• Comparison with manual React Native setup
• Installation
• Usage
• Interactive CLI walkthrough
• Screenshots & GIFs
• Generated folder structure
• Supported React Native versions
• Firebase setup
• Push notifications
• Splash screen
• App icon generation
• Supported platforms
• Requirements
• Examples
• Troubleshooting
• FAQ
• Documentation
• Contributing
• Roadmap
• License

Features

• Create React Native App experience via npx
• Bare React Native Android & iOS scaffold (@react-native-community/cli)
• Optional React Native starter package groups (navigation, animation, camera, Firebase, …)
• Compatible stable version resolution (no hardcoded peer versions)
• React Native Firebase config copy + Gradle / AppDelegate wiring
• FCM / push notifications (@react-native-firebase/messaging, Notifee)
• Native app icon generation (Android mipmaps + iOS AppIcon)
• Splash screen via BootSplash, react-native-splash-screen, or native assets
• Idempotent Babel / entry / permissions / Info.plist steps
• Interactive or fully non-interactive (--yes)

Why use this package?

Blank npx @react-native-community/cli init is a great starting point—but teams still re-do Firebase, FCM, icons, splash, and peer-compatible installs on every project.

create-react-native-setup is a React Native bootstrap / project generator that keeps bare RN ownership while removing repetitive setup.

Comparison with manual React Native setup

| Task | Manual bare RN | create-react-native-setup | |------|----------------|---------------------------| | Create app | Community CLI init | Same foundation + guided extras | | Pick libraries | Search, trial, peer conflicts | Catalog groups + compatible resolve | | Firebase | Hand-edit Gradle / AppDelegate | Optional automated wiring | | Push / FCM | Permissions + bootstrap by hand | messaging / Notifee options | | App icon | Multiple densities / Xcode slots | One image → generated assets | | Splash | Native themes / BootSplash CLI | Package choice + auto native wire | | Visibility | Guess what changed | Terminal report + JSON |

Installation

Prefer npx (no global install):

npx create-react-native-setup MyApp

Optional global install:

npm install -g create-react-native-setup
create-react-native-setup MyApp

npm install create-react-native-setup only installs the CLI. It does not create a project. Always invoke the binary.

Usage

npx create-react-native-setup [projectName] [options]

| Option | Description | |--------|-------------| | --yes, -y, --default | Accept defaults; skip prompts | | --rn-version <ver> | Pin React Native version | | --icon <file> | Source image for app icons | | --splash <file> | Source image for splash / BootSplash | | --splash-package <id> | bootsplash | splash-screen | native | | --google-services <file> | Android google-services.json | | --google-service-info <file> | iOS GoogleService-Info.plist | | --notifications <list> | messaging, notifee, or none | | --config <file> | Custom package catalog | | --dry-run | Plan only; no create/install | | --help, -h | Help |

Interactive CLI walkthrough

When you run without --yes:

1. Project name
2. React Native version (blank = latest stable)
3. Package groups (Navigation, Animation, Camera, Firebase, …)
4. Notifications multi-select (if enabled)
5. Firebase config paths (if Firebase / messaging is in play)
6. App icon? → path
7. Splash screen? → package + path + background
8. Automatic create → install → native setup → report

Screenshots & GIFs

Add media under docs/assets/ after capture.

docs/assets/cli-walkthrough.gif      # interactive prompts
docs/assets/report.png               # final report
docs/assets/android-splash.png       # cold start splash
docs/assets/app-icon.png             # generated icon

Generated folder structure

MyApp/
├── android/          # Bare React Native Android
├── ios/              # Bare React Native iOS
├── src/              # Optional helpers (e.g. notifications)
├── App.tsx
├── index.js
├── package.json
├── babel.config.js
└── create-react-native-setup-report.json

Supported React Native versions

• Default: latest stable React Native
• Pin with --rn-version (e.g. 0.81.6, 0.86.2)
• Validated against recent Community CLI templates (~0.81–0.86)
• Requires Node.js 18+

Firebase setup

See docs/Firebase.md.

Copies google-services.json / GoogleService-Info.plist, wires Google Services Gradle and iOS FirebaseApp.configure().

Push notifications

See docs/PushNotifications.md.

Optional @react-native-firebase/messaging (FCM) and/or @notifee/react-native, Android POST_NOTIFICATIONS, iOS background modes, and a JS bootstrap file.

Splash screen

See docs/SplashScreen.md.

• react-native-bootsplash (recommended) — auto BootTheme, Manifest, MainActivity, AppDelegate
• react-native-splash-screen
• Native assets only

App icon generation

See docs/Icons.md.

One image → Android launcher densities + iOS AppIcon.appiconset.

Supported platforms

| Platform | Support | |----------|---------| | Android | Yes (bare RN) | | iOS | Yes (macOS for pods / device) | | Expo managed | No — use Expo tooling instead | | Web | No |

Requirements

• Node.js 18+
• npm registry access
• Android SDK for run-android (ANDROID_HOME)
• macOS + CocoaPods for iOS

Examples

# React Native starter — interactive
npx create-react-native-setup

# React Native boilerplate defaults
npx create-react-native-setup ShopApp --yes

# React Native Firebase + FCM
npx create-react-native-setup ShopApp --yes \
  --notifications messaging,notifee \
  --google-services ./google-services.json \
  --google-service-info ./GoogleService-Info.plist

# Splash screen + app icon
npx create-react-native-setup ShopApp --yes \
  --icon ./brand/icon.png \
  --splash ./brand/splash.png \
  --splash-package bootsplash

# Dry-run (CI-friendly)
npx create-react-native-setup ShopApp --yes --dry-run

Before: blank Community CLI app + hours of wiring.
After: report listing installed packages, native steps, and remaining manual actions (e.g. APNs).

Troubleshooting

See docs/Troubleshooting.md for Android SDK, BootTheme, pods, and npm auth issues.

FAQ

See docs/FAQ.md.

Documentation

| Guide | Path | |-------|------| | Installation | docs/Installation.md | | Configuration | docs/Configuration.md | | Examples | docs/Examples.md | | Firebase | docs/Firebase.md | | Push notifications | docs/PushNotifications.md | | Icons | docs/Icons.md | | Splash screen | docs/SplashScreen.md | | FAQ | docs/FAQ.md | | Troubleshooting | docs/Troubleshooting.md | | Migration | docs/Migration.md |

Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

git clone https://github.com/Sainidinesh123/create-react-native-setup.git
cd create-react-native-setup
npm install
npm test

Roadmap

• [ ] First-class TypeScript template flags docs
• [ ] Demo GIF + social preview assets in-repo
• [ ] Optional CI workflow badge for GitHub Actions
• [ ] Gallery of generated report screenshots
• [ ] More catalog groups requested by the community

Security reports: SECURITY.md · Support: SUPPORT.md

License

MIT © Sainidinesh123

npm: https://www.npmjs.com/package/create-react-native-setup
Changelog: CHANGELOG.md