Skip to main content

​
✨ What’s Included

Authentication

Secure user signup, login, and account management powered by Supabase.

Payments

Seamless in-app subscriptions for iOS and Android using RevenueCat.

Analytics

Gain deep insights into user behavior with PostHog analytics and feature flags.

Error Tracking

Proactively catch and resolve issues with Sentry error monitoring.

Push Notifications

Engage your users effectively with integrated push notifications.

AI-Optimized

Engineered for “vibecoding” – build faster by describing your needs to AI.

​
🏃 Quick Start (2 Minutes)

For Vibecoders: Just want to start building? Here’s the fastest path.
# 1. Clone the repository
git clone https://github.com/shipnativeapp/shipnative.git
cd shipnative

# 2. Install dependencies
yarn install

# 3. Start building (runs in mock mode - no API keys needed!)
cd apps/app
yarn ios        # or yarn android
That’s it! The app will run with mock services, so you can start vibecoding immediately.
What is Mock Mode? Shipnative runs with simulated backend services when API keys aren’t configured. This means you can build your entire frontend, test features, and develop with AI assistance without setting up any external services. Add real API keys only when you’re ready to deploy.

​
🎯 Choose Your Path

I Want to Vibecode

Start building immediately with AI assistance. No setup required.

I Want to Configure Everything

Set up backend services, configure API keys, and understand the full stack.

​
📚 Documentation

Quickstart (Vibecoders)

Start building in 2 minutes with AI assistance

Full Setup Guide

Configure all services and understand the stack

Core Features

Auth, payments, analytics, notifications

Development Guide

Styling, state management, AI development

​
🤖 Vibecoding with AI

Shipnative is optimized for AI-assisted development. Use this prompt with Claude, Cursor, or any AI coding assistant:
The Golden Prompt:
Read the .cursorrules file and the vibe/ folder.
I want to build a [describe your app].
Start by outlining the database schema changes I need.
This prompt tells the AI to:
  1. Read project rules (.cursorrules) and context files (vibe/ folder)
  2. Use existing components and follow established patterns
  3. Generate code using Unistyles for styling
  4. Build features that fit seamlessly into the codebase

​
🎓 New to Vibecoding?

Vibecoding means building apps by describing features to AI instead of writing boilerplate from scratch. Shipnative makes this possible by:
  • Pre-built components - Buttons, forms, cards, all styled and ready
  • Mock services - Test auth, payments, analytics without API keys
  • AI context files - The vibe/ folder teaches AI about your codebase
  • Clear patterns - Consistent code structure AI can follow
Start with something simple like: “Add a profile screen where users can update their name and avatar” and watch the AI build it using Shipnative’s components and patterns.