https://github.com/onflow/frw-monorepo
Flow Reference Wallet - Monorepo with React Native app, Chrome extension, and shared packages
https://github.com/onflow/frw-monorepo
Last synced: 4 months ago
JSON representation
Flow Reference Wallet - Monorepo with React Native app, Chrome extension, and shared packages
- Host: GitHub
- URL: https://github.com/onflow/frw-monorepo
- Owner: onflow
- License: mit
- Created: 2025-08-04T15:48:16.000Z (10 months ago)
- Default Branch: dev
- Last Pushed: 2026-01-15T05:27:20.000Z (5 months ago)
- Last Synced: 2026-01-15T07:58:00.676Z (5 months ago)
- Language: TypeScript
- Size: 184 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 81
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Flow Reference Wallet (FRW) 🌊
> Production-ready Flow blockchain wallet with React Native and Browser
> Extension
[](https://www.typescriptlang.org/)
[](https://reactnative.dev/)
[](https://pnpm.io/)
[](https://flow.com/)
[](https://github.com/onflow/FRW-monorepo/actions/workflows/extension-e2e.yml)
## 📁 Project Structure
```
FRW-monorepo/
├── apps/
│ ├── react-native/ # React Native shared code & Metro bundler
│ │ ├── ios/ # iOS native app (git submodule: FRW-iOS)
│ │ └── android/ # Android native app (git submodule: FRW-android)
│ └── extension/ # Browser extension (Chrome/Firefox)
├── packages/ # Shared libraries
│ ├── types/ # TypeScript definitions & data models
│ ├── api/ # HTTP API clients for backend services
│ ├── cadence/ # Flow blockchain interaction & smart contracts
│ ├── services/ # Business logic & domain services
│ ├── workflow/ # Transaction workflows & orchestration
│ ├── stores/ # State management (Zustand stores)
│ ├── ui/ # Reusable UI components (Tamagui)
│ ├── icons/ # SVG icon components
│ ├── screens/ # Complete screen implementations
│ ├── utils/ # Utility functions & helpers
│ └── context/ # Dependency injection & platform abstraction
├── docs/ # Documentation & guidelines
└── tools/ # Build tools & configurations
```
## 🚀 Quick Start
### Prerequisites
```bash
# Required versions
node >= 20.0.0
pnpm >= 9.0.0
```
**For React Native development**, follow the official
[React Native Environment Setup](https://reactnative.dev/docs/set-up-your-environment)
guide:
- **iOS development**: Xcode >= 14, CocoaPods >= 1.15
- **Android development**: Android Studio, Java 17+
### Installation
```bash
# Clone repository with submodules
git clone --recurse-submodules https://github.com/onflow/FRW-monorepo
cd FRW-monorepo
# Or if already cloned, initialize submodules
git submodule update --init --recursive
# Install dependencies
pnpm install
# Build all packages
pnpm build
```
### Development
```bash
# Option 1: Separate terminals (recommended)
pnpm dev:packages # Terminal 1: Watch packages for changes
pnpm dev:rn # Terminal 2: Start React Native
# Option 2: Combined (single terminal)
pnpm dev:rn:full # Both packages watch + RN start
```
### Platform Specific
```bash
# React Native
pnpm dev:rn # Start Metro bundler
pnpm run ios # Run on iOS simulator
pnpm run android # Run on Android emulator
# Browser Extension
cd apps/extension
pnpm dev # Development build
pnpm build # Production build
```
## 📚 Documentation
For detailed development guidelines and best practices:
- **[Development Guidelines](./docs/DEVELOPMENT_GUIDELINES.md)** - Coding
standards, architecture rules, and common patterns
- **[Contributing Guide](./docs/CONTRIBUTING.md)** - How to contribute to the
project
- **[Architecture Guide](./docs/ARCHITECTURE.md)** - Technical architecture
documentation
## 🤝 Contributing
1. Fork the repository
2. Create your feature branch: `git checkout -b feat/amazing-feature`
3. Follow our [Development Guidelines](./docs/DEVELOPMENT_GUIDELINES.md)
4. Commit with conventional format: `git commit -m "feat: add amazing feature"`
5. Run quality checks: `pnpm lint && pnpm typecheck && pnpm build`
6. Submit a pull request
Please read our **[Contributing Guide](./docs/CONTRIBUTING.md)** for detailed
instructions.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
for details.
---
**Built with ❤️ by the Flow Foundation team**
_Ready to build the future of decentralized finance on Flow!_ 🚀