create-twinbloc-app
v0.1.23
Published
Create Twinbloc React Native apps with Expo, TypeScript, and a production-ready starter template
Maintainers
Readme
Create TwinBloc App
The official CLI for scaffolding production-ready React Native applications with Expo, TypeScript, and a curated modern stack.
Quick Start
npx create-twinbloc-app@latestThe interactive CLI will guide you through:
- Project naming — with Android package convention validation
- Template selection — Base or example variants
- AI agent configuration — Pre-configure for VS Code, Cursor, Windsurf, Trae, and more
Documentation
Full documentation is available at rn-starter.twinbloc.org
- Installation Guide — Requirements, setup, and running your app
- Project Structure — File organization and architecture
- Configuration — Environment variables, theming, and customization
Features
- Core: Expo SDK 56, React Native 0.85, React 19.2
- Language: TypeScript-first with strict configuration
- Navigation: Expo Router (file-based routing) with typed routes
- Styling: UniWind (Universal Tailwind CSS) with
tailwind-mergeandtailwind-variants - State Management: Zustand for global state, TanStack Query for server state
- Storage: MMKV for fast synchronous storage with Zustand persistence
- Networking: Axios client with interceptors and request helpers
- Forms: React Hook Form with Zod validation
- Localization: i18next with multi-language support (English, Spanish, French, Arabic)
- UI Components: 20+ reusable primitives (Button, Input, BottomSheet, Avatar, Accordion, etc.)
- Testing: Jest for unit/integration tests, Maestro for E2E testing
- Code Quality: ESLint, Prettier, Husky, Commitlint
- Animations: Reanimated 4 for smooth animations
- Additional: FlashList for performant lists, Gesture Handler
Requirements
- Node.js: >= 18.0.0
- Package Manager: pnpm 11.6.0 (recommended), npm, or yarn
- iOS: macOS with Xcode installed
- Android: Android Studio with SDK configured
License
MIT — Copyright (c) 2024 Twinbloc Studios
