Open Source by Death Legion Team

Write Once. Run Everywhere.

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

Watch Demo

terminal
$ npx princo init my-app
✓ Scaffolding project from template...
✓ Installing dependencies...
✓ Configuring Android, iOS & Web targets
$ cd my-app && princo start
🚀 Your app is running on all platforms!

Android

iOS

Web

Everything You Need to Ship Fast

Princo isn't just a framework — it's a complete ecosystem designed to take you from first line of code to millions of users, without stitching together a dozen tools.

True Native Performance

Princo compiles your React components to truly native UI elements on every platform. No web views, no compromises — buttery smooth 60fps animations and native gesture handling out of the box.

One Codebase, Three Platforms

Write your app logic and UI in JavaScript and TypeScript once. Princo handles platform differences automatically with intelligent abstraction layers, so your code runs identically on Android, iOS, and the web.

Powerful CLI Tool

The `princo` CLI scaffolds projects, manages configurations, runs development servers, and handles production builds — all from a single command. Pre-built templates get you from zero to running in under 60 seconds.

50+ Native Modules

Camera, GPS, Bluetooth, biometrics, push notifications, file system, and dozens more — all wrapped in a consistent, promise-based JavaScript API. No more wrestling with platform-specific native code.

Go Companion App

The Princo Go app for Android and iOS lets you preview changes instantly — no rebuilds, no cables, no Xcode. Scan a QR code and your app loads on your device in under 2 seconds with full hot reload.

Integrated Cloud Services

Build binaries in the cloud, submit to App Store and Google Play automatically, and push over-the-air updates that bypass app review. The entire deployment pipeline, handled for you.

World-Class Documentation

Comprehensive guides, interactive API references, video tutorials, and a searchable knowledge base. Every module documented with real-world examples, platform notes, and migration guides.

Type-Safe by Default

Built from the ground up with TypeScript. Every API, every module, every configuration option is fully typed. Catch errors at compile time, not in production, with best-in-class IDE autocompletion.

Blazing Fast Refresh

See your changes reflected in milliseconds. Princo's Hot Module Replacement is optimized for native — state is preserved across reloads, and the entire UI updates without losing your place.

OTA Updates

Push JavaScript bundle updates directly to your users without going through app store review. Roll out fixes, A/B test features, and iterate at web speed on native platforms.

Plugin Architecture

Extend Princo with community plugins or build your own. The plugin system supports native code on all platforms, auto-linking, and seamless integration with the CLI build pipeline.

Platform Abstraction

Need platform-specific code? Use the `.android.ts`, `.ios.ts`, and `.web.ts` file extensions for clean separation. Or use the `Platform.select()` API for inline branching — your choice.

CLI Tool

From Zero to Running in Under 60 Seconds

The princo CLI is your single entry point for every task in the development lifecycle. Scaffold projects from production-ready templates, spin up dev servers with hot reload across all platforms, build optimized production binaries, and push over-the-air updates — all from one tool.

princo-cli

$ npx princo init my-app

✓ Created project structure

✓ Installed 142 dependencies

✓ Configured Android, iOS & Web

✓ Generated TypeScript config

Next steps:

cd my-app

princo start

Write Once, Run Everywhere

Clean Code, Platform Freedom

Write shared code that runs identically on all platforms. When you need platform-specific behavior, use file extensions or the Platform API — no hacky conditionals, just clean separation.

App.tsx
screens/Home.tsx
utils/share.android.ts
utils/share.ios.ts
utils/share.web.ts
1import React from 'react';
2import { View, Text, StyleSheet } from 'princo';
3import { PrincoTheme } from 'princo/theme';
4import { HomeScreen } from './screens/Home';
5
6export default function App() {
7  return (
8    <PrincoTheme mode="dark">
9      <View style={styles.container}>
10        <HomeScreen />
11      </View>
12    </PrincoTheme>
13  );
14}
15
16const styles = StyleSheet.create({
17  container: {
18    flex: 1,
19    backgroundColor: '#0a0a0a',
20  },
21});

.android.ts

Auto-resolved on Android

.ios.ts

Auto-resolved on iOS

.web.ts

Auto-resolved on Web

Module Library

50+ Native Modules, Zero Native Code

Access every native device capability through a clean, promise-based JavaScript API. No Swift, no Kotlin, no Gradle — just JavaScript that works on every platform.

App.tsx
import { PrincoCamera } from 'princo/camera'
import { PrincoGeo } from 'princo/geo'
const photo = await PrincoCamera.capture({
quality: 'high',
flash: 'auto'
}
const location = await PrincoGeo.getCurrentPosition()

Go Companion App

Instant Preview, Zero Rebuilds

The Princo Go app eliminates the slowest part of mobile development: waiting for builds. Scan a QR code, and your app is running on your phone in seconds. Every save is instantly reflected.

9:41

Princo Go

Scan to load your dev server

Connected to Dev Server

my-app

<2s load

Hot Reload

Step 01

Scan the QR Code

Open the Princo Go app on your Android or iOS device and point it at the QR code displayed by your dev server. No USB cable, no pairing, no configuration — just scan and go.

Step 02

App Loads Instantly

Your entire app bundle streams to the device over Wi-Fi in under 2 seconds. The Go app uses a lightweight native container that renders your React components at full native speed.

Step 03

Edit & See Changes Live

Save a file in your editor and watch the change appear on your device instantly. Hot Module Replacement preserves your app state — navigate to a deep screen, edit a component, and see the update without losing your place.

Step 04

Test on Real Hardware

No simulator can replicate real touch gestures, camera behavior, or sensor data. With the Go app, you test on actual hardware with real haptics, real GPS, real biometrics — everything works exactly as your users will experience it.

Cloud Services

Deploy at Web Speed, On Native Platforms

The entire deployment pipeline — from build to store submission to live updates — handled by integrated cloud services. Spend your time building features, not fighting infrastructure.

Princo Build

Cloud Build Service

Upload your JavaScript bundle and get back signed, optimized AAB and IPA files. No more wrestling with Android SDK, NDK versions, or Xcode build settings. Our cloud infrastructure handles the entire native compilation pipeline — you just run `princo build --cloud` and download your binaries when they're ready.

Key Features

Automatic code signing & provisioning
Parallel builds for Android & iOS
Build caching for incremental changes
Custom build configurations per environment

Princo Submit

App Store Submission

Submit your built app to Google Play and the App Store with a single command. Princo Submit handles metadata, screenshots, pricing, and rollout configuration. It integrates with your CI/CD pipeline so every tagged release is automatically submitted for review — no manual upload forms, no forgotten screenshots.

Key Features

One-command store submission
Automated screenshot generation
Metadata management per locale
Staged rollout configuration

Princo Update

Over-the-Air Updates

Push JavaScript and asset updates directly to your users without going through app store review. Princo Update uses differential patching to minimize download sizes and includes a rollback mechanism for instant reversion. A/B test different versions, roll out gradually, and monitor adoption in real time.

Key Features

Differential patching (90% smaller downloads)
Gradual rollout with percentage controls
Instant rollback on errors
Real-time adoption analytics

The Complete Pipeline

Git PushTrigger build

BuildCloud compile

SubmitStore review

ReleaseStaged rollout

UpdateOTA patches

Documentation

Documentation That Actually Helps

No more digging through outdated wiki pages. Princo's documentation is versioned, searchable, interactive, and always up to date with the latest release.

Ctrl K

Getting Started

Install the CLI, create your first project, and run it on all three platforms in under five minutes.

API Reference

Complete reference for every Princo module, component, and utility. Fully typed, fully documented, with interactive examples.

Video Tutorials

Step-by-step video walkthroughs covering everything from basics to advanced patterns like native module bridging.

Community & Support

Join thousands of developers in our Discord, browse answered questions, or file issues directly on GitHub.

500+

Documentation Pages

120+

Code Examples

40+

Video Tutorials

24/7

Community Support

Open Source

Built by the Community, For the Community

Princo is 100% open source under the MIT license. Every line of code, every module, every cloud service connector — it's all on GitHub. Contribute, fork, or build your own. No vendor lock-in, ever.

24.8kstars

3.2kforks

480+contributors

View on GitHub

+472