|
| 1 | +# Helium Wallet App |
| 2 | + |
| 3 | +React Native Solana wallet with extensive Helium ecosystem integration. |
| 4 | + |
| 5 | +## Commands |
| 6 | + |
| 7 | +```bash |
| 8 | +yarn # Install dependencies |
| 9 | +yarn pod-install # iOS pods (run `bundle install` first) |
| 10 | +yarn ios # Run iOS app |
| 11 | +yarn android # Run Android app |
| 12 | +yarn lint # ESLint + TypeScript check |
| 13 | +yarn test # Jest tests |
| 14 | +yarn clean-start # Metro with cache clear |
| 15 | +yarn bump-patch # Version bump (also: bump-minor, bump-major) |
| 16 | +``` |
| 17 | + |
| 18 | +## Architecture |
| 19 | + |
| 20 | +### Structure |
| 21 | +- **Feature-based** - `src/features/` (account, payment, governance, swaps, browser, etc.) |
| 22 | +- **Redux Toolkit** - `src/store/slices/` with RTK Query |
| 23 | +- **Redux Persist** - app/auth/hotspots/browser slices persisted |
| 24 | +- **Shopify Restyle** - theming in `src/theme/` |
| 25 | +- **React Navigation v6** - Stack + Bottom Tabs |
| 26 | +- **Provider hierarchy** - 17+ nested providers in App.tsx |
| 27 | + |
| 28 | +### Solana/Helium |
| 29 | +- `src/solana/` - SolanaProvider, WalletSignProvider, account cache |
| 30 | +- 36+ @helium/* packages for SDKs, hooks, IDLs |
| 31 | +- Hardware wallets: Ledger (BLE), Keystone (QR) |
| 32 | +- Transaction building via @helium/transactions |
| 33 | + |
| 34 | +## Import Aliases |
| 35 | + |
| 36 | +`@components`, `@hooks`, `@utils`, `@theme`, `@storage`, `@types`, `@assets`, `@constants`, `@helium/crypto` |
| 37 | + |
| 38 | +## Code Style |
| 39 | + |
| 40 | +- Airbnb + Prettier (single quotes, no semicolons, trailing commas) |
| 41 | +- `_` prefix for unused vars |
| 42 | +- Redux slices exempt from param-reassign rule |
| 43 | +- console.warn/error allowed, console.log stripped in production |
0 commit comments