What is Princo?

Princo is an open-source framework that lets you build universal native apps for Android, iOS, and the web — all from a single React codebase. No compromises on performance, no platform-specific headaches, and no vendor lock-in.

Built by the Death Legion Team.

Quick Start

# Create a new project
npx princo init my-app

# Navigate into the project
cd my-app

# Start developing on all platforms
princo start

CLI Commands

| Command | Description | |---------|-------------| | princo init [name] | Scaffold a new project from a template | | princo start | Start the dev server with hot reload | | princo build --platform all | Build production binaries for all platforms | | princo update --push | Push an OTA update to all users | | princo modules | List available native modules | | princo doctor | Check your development environment |

Native Modules

Princo includes 50+ native modules with a consistent, promise-based JavaScript API:

• 📷 Camera — princo/camera
• 📍 Geolocation — princo/geo
• 📡 Bluetooth — princo/ble
• 🔐 Biometrics — princo/bio
• 🔔 Notifications — princo/notify
• 📁 File System — princo/fs
• 📤 Share — princo/share
• 🔄 Haptics — princo/haptic
• 🔑 Auth — princo/auth
• ...and 40+ more

Platform-Specific Code

Need platform-specific code? Use file extensions for clean separation:

src/utils/
  share.android.ts   ← Auto-resolved on Android
  share.ios.ts       ← Auto-resolved on iOS
  share.web.ts       ← Auto-resolved on Web

Or use the Platform API:

import { Platform } from 'princo';

const apiKey = Platform.select({
  android: 'android-key',
  ios: 'ios-key',
  web: 'web-key',
});

Go Companion App

The Princo Go app for Android and iOS lets you preview changes instantly — no rebuilds, no cables:

1. 📱 Open Princo Go on your device
2. 📷 Scan the QR code from your dev server
3. ✏️ Edit code and see changes live with hot reload
4. 🧪 Test on real hardware with native features

Cloud Services

• Princo Build — Cloud builds for Android & iOS. No local SDK required.
• Princo Submit — One-command app store submission.
• Princo Update — Over-the-air updates that bypass app review.

# Build in the cloud
princo build --cloud

# Submit to stores
princo submit

# Push an OTA update
princo update --push --rollout 25

Contributing

We welcome contributions! Please see our Contributing Guide.

License

MIT © Death Legion Team