Welcome to your Pubflow React Native App

This is a Pubflow React Native Starter Kit built with Expo and the Pubflow client libraries.

Documentation

• Flowless (Authentication Backend): https://flowless.dev/
• Flowfull Client Libraries: https://clients.flowfull.dev/
• Bridge Payments: https://bridgepayments.dev/

Features

• @pubflow/core 0.5.1 — core auth, bridge, and session helpers
• @pubflow/react-native 0.5.1 — React Native adapter
• Expo SDK 57 — React Native 0.86 + Expo Router
• Authentication — login, register, recovery, and 2FA
• Bridge API — list and profile screens ready to extend
• Offline indicator — session-aware offline feedback
• TypeScript + Expo Router

Quick start

1. Install dependencies

   npm install

2. Configure environment

   cp .env.example .env

   Set at least:

   EXPO_PUBLIC_API_BASE_URL=https://your-instance.example.com
   EXPO_PUBLIC_BUSINESS_NAME=Pubflow
   EXPO_PUBLIC_MAIN_COLOR=#006aff

   Notes:

   • EXPO_PUBLIC_LOGO / EXPO_PUBLIC_DARK_LOGO must be http(s) URLs if set; leave empty to use the bundled logo (dark falls back to a soft light plate around the default mark).
   • Without EXPO_PUBLIC_API_BASE_URL, Home shows a setup banner so you know to configure Flowless.

3. Start the app

   npx expo start

Open it in a development build, Android emulator, iOS simulator, or Expo Go.

Home welcome screen

/ always shows the home welcome (components/HomeWelcome.tsx). Edit copy in locales/*/common.json under home.welcome. CTAs go to Login or Continue into the signed-in tabs; AuthContext still protects tab routes.

Signed-in tabs

After auth, /(tabs) has three screens:

• Home — product landing: greeting, session/API chips, action tiles, stack card
• Explore — Flowless / Flowfull / Pubflow ecosystem + “already in this kit” checklist
• Profile — account, appearance (system/light/dark), language (EN/ES), logout

Dark mode follows system by default; override in Profile. Locales live in locales/{en,es}/common.json (i18next + expo-localization + AsyncStorage).

Project structure

• app/index.tsx — home welcome entry
• components/HomeWelcome.tsx — public welcome UI (easy to edit)
• app/login.tsx, create-account.tsx, account-recovery.tsx — auth screens
• app/(tabs)/ — Home, Explore, Profile
• utils/pubflow-config.ts — shared env helpers
• .env.example — documented environment template

Learn more

• Expo documentation
• Expo Router