Flowfull Clients Docs

Appearance

Starter Kits ​

Get started quickly with our official starter kits. These are production-ready templates that include authentication, routing, and best practices for building applications with Pubflow.

🚀 Available Starter Kits ​

Complete Onboarding Path

For the best onboarding experience, combine these frontend starter kits with a Flowfull backend starter:

This keeps your stack simple: frontend clients + custom Flowfull backend + Flowless auth.

Next.js ​

A complete Next.js frontend starter with Pubflow auth, routing, API wiring, and production-ready structure.

Repository: github.com/pubflow/next-flowfull-client

Features:

  • Complete authentication system (login, registration, password reset)
  • Next.js App Router
  • Protected routes with automatic redirects
  • Professional UI with Tailwind CSS + shadcn/ui
  • Dynamic theming and branding
  • Debug tools for development
  • TypeScript support
  • i18n internationalization ready

Tech Stack:

  • Next.js
  • React
  • @pubflow/react
  • Tailwind CSS 4
  • shadcn/ui components

Quick Start:

bash
git clone https://github.com/pubflow/next-flowfull-client.git
cd next-flowfull-client
npm install
npm run dev

Compatible with:

  • Next.js App Router
  • Server components and client components
  • Existing Next.js apps

TanStack Start (React) ​

A complete React application using TanStack Start with Pubflow integration.

Repository: github.com/pubflow/react-flowfull-client

Features:

  • Complete authentication system (login, registration, password reset)
  • TanStack Router with file-based routing
  • Protected routes with automatic redirects
  • Professional UI with Tailwind CSS + shadcn/ui
  • Dynamic theming and branding
  • Offline support with network detection
  • Advanced components (BridgeList, AdvancedFilter)
  • Debug tools for development
  • TypeScript support
  • i18n internationalization ready

Tech Stack:

  • React 19
  • TanStack Start + Router
  • @pubflow/react
  • Tailwind CSS 4
  • shadcn/ui components
  • Vite

Quick Start:

bash
git clone https://github.com/pubflow/react-flowfull-client.git
cd react-flowfull-client
npm install
npm run dev

Compatible with:

  • TanStack Start
  • Vite + React
  • Any React-based framework that wants the same client patterns

React Native Expo ​

A complete React Native application using Expo with Pubflow integration.

Repository: github.com/pubflow/create-pubflow-rn

Features:

  • ✅ Complete authentication system (login, registration, password recovery)
  • ✅ Expo Router with file-based routing
  • ✅ Protected routes with automatic redirects
  • ✅ Professional UI with native components
  • ✅ Offline support with network detection
  • ✅ Secure storage with Expo SecureStore
  • ✅ Image upload with Expo ImagePicker
  • ✅ User profile management
  • ✅ Bridge components (BridgeView, BridgeList, BridgeForm)
  • ✅ Debug utilities for development
  • ✅ TypeScript support
  • ✅ Cross-platform (iOS, Android, Web)

Tech Stack:

  • React Native 0.79
  • Expo SDK 53
  • @pubflow/react-native
  • Expo Router
  • Expo SecureStore
  • React Hook Form + Zod

Quick Start:

bash
# Clone the repository
git clone https://github.com/pubflow/create-pubflow-rn.git
cd create-pubflow-rn

# Install dependencies
npm install

# Configure environment
# Create .env file with your configuration

# Start development server
npx expo start

Environment Variables:

env
EXPO_PUBLIC_BRIDGE_URL=http://localhost:8787
EXPO_PUBLIC_LOG_MODE=development

Compatible with:

  • Expo (recommended)
  • Bare React Native

Flowfull Rust Backend Starter ​

A production-ready Rust backend starter using Axum, Tokio, SQLx, Flowless Bridge validation, and Trust token helpers.

Repository: github.com/pubflow/flowfull-rust-starter

Features:

  • Axum router with public, optional, protected, profile, admin, and task example routes
  • Local Flowless Bridge validator with retry, timeout, and configurable validation endpoint
  • Auth middleware for require_auth, optional_auth, require_roles, require_roles_csv, and admin-only require_admin
  • SQLx database setup, health checks, local TTL cache, optional Redis wiring
  • PASETO v4 Trust token helpers for short-lived signed claims
  • Docker, typed environment config, tracing, CORS, and tests

Tech Stack:

  • Rust
  • Axum
  • Tokio
  • SQLx
  • Reqwest
  • PASETO v4

Quick Start:

bash
pubflow create rust-backend my-api
cd my-api
cp .env.example .env
cargo run

Client package:

bash
cargo add flowfull

Compatible with:

  • Axum APIs
  • Flowless Bridge validation
  • Flowfull frontend clients
  • Existing Rust backends that want to adopt Flowless sessions gradually

🎯 Choosing a Starter Kit ​

Use Next.js if you need: ​

  • Web application
  • SEO and server-side rendering
  • Next.js App Router conventions
  • Server/client component patterns
  • Integration with existing Next.js infrastructure

Use TanStack Start (React) if you need: ​

  • React web application
  • TanStack Router
  • Desktop-first experience
  • Complex routing and data loading
  • Integration with existing React ecosystem

Use React Native Expo if you need: ​

  • Mobile application (iOS/Android)
  • Native device features (camera, storage, notifications)
  • Cross-platform mobile app
  • App store distribution
  • Mobile-first experience

📦 What's Included ​

All starter kits include:

Authentication ​

  • Login with email/password
  • Account registration
  • Password recovery
  • Session management
  • Automatic token refresh
  • Protected routes

UI Components ​

  • Professional, production-ready design
  • Responsive layouts
  • Form validation with Zod
  • Loading states and error handling
  • Offline indicators
  • User profile components

Developer Experience ​

  • TypeScript for type safety
  • Hot reload for fast development
  • Debug utilities
  • Environment-based configuration
  • Code organization best practices

Pubflow Integration ​

  • Pre-configured @pubflow packages
  • Bridge API integration
  • Authentication flow
  • Session storage
  • API client setup

🛠️ Customization ​

All starter kits are designed to be customized:

  1. Branding: Update colors, logos, and app name via environment variables
  2. Routes: Add new routes using file-based routing
  3. Components: Extend or replace UI components
  4. API: Add custom API endpoints and business logic
  5. Styling: Customize themes and styles

🤝 Community Starter Kits ​

Want to create a starter kit for another framework? We welcome community contributions!

See Build Your Own Client for guidance on creating Pubflow integrations for other frameworks.

📚 Next Steps ​

After setting up your starter kit:

  1. Configure your Flowfull backend - See Flowfull Documentation
  2. Customize the UI - Update branding and styling
  3. Add your features - Build your application logic
  4. Deploy - Deploy to production

Need help? Contact us at support@pubflow.com

Need a new starter, SDK, or integration?