What is Pubflow?

Pubflow is a complete architecture for building modern applications in record time. It provides a trust-based authentication system that powers your entire application stack.

The Pubflow Architecture

┌─────────────────────────────────────────────────────────┐
│                  PUBFLOW ARCHITECTURE                    │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌──────────────┐      ┌──────────────┐      ┌────────┐│
│  │   FLOWLESS   │ ───▶ │   FLOWFULL   │ ───▶ │ CLIENT ││
│  │              │      │              │      │        ││
│  │ • Auth       │      │ • Your APIs  │      │ • React││
│  │ • Sessions   │      │ • Business   │      │ • Next ││
│  │ • Users      │      │ • Database   │      │ • RN   ││
│  └──────────────┘      └──────────────┘      └────────┘│
│   pubflow.com          Your Backend          Your App   │
│                                                          │
└─────────────────────────────────────────────────────────┘

The Three Layers

1. 🔐 Flowless - Core Authentication

Flowless is the core authentication backend deployed on Pubflow.

What it handles:

• ✅ User registration and login
• ✅ Session management
• ✅ Password reset and email verification
• ✅ User profiles and authentication
• ✅ Trust token generation
• ✅ Bridge validation for your backends

Key features:

• Managed service on Pubflow.com
• No setup or maintenance required
• Enterprise-grade security
• Automatic scaling
• 99.9% uptime SLA

How to use:

1. Sign up at pubflow.com
2. Create a Flowless instance
3. Get your Bridge Secret
4. Connect your Flowfull backend

2. ⚡ Flowfull - Your Custom Backend

Flowfull is YOUR backend - where your business logic lives.

What you build:

• ✅ Custom APIs for your application
• ✅ Business logic and workflows
• ✅ Database models and queries
• ✅ Cache management
• ✅ Third-party integrations

Key features:

• Connects to Flowless for authentication
• Stateless and horizontally scalable
• Multi-database support
• 3-tier HybridCache system
• Language agnostic (Node.js, Go, Python, Rust)

How it works:

// Your Flowfull backend
app.get('/api/items', requireAuth(), async (c) => {
  const userId = c.get('user_id');  // From Flowless
  
  // Your business logic
  const items = await db.getItems(userId);
  return c.json({ items });
});

3. 🎨 Flowfull-Client - Your Frontend

Flowfull-Client is your frontend application.

Supported frameworks:

• ✅ React
• ✅ Next.js
• ✅ React Native
• ✅ Vue.js
• ✅ Any framework you choose

Key features:

• Pre-built authentication components
• Session management
• API client with automatic auth headers
• TypeScript support

How it works:

// Your frontend
import { usePubflow } from '@pubflow/react';

function Profile() {
  const { user, isAuthenticated } = usePubflow();
  
  if (!isAuthenticated) {
    return <Login />;
  }
  
  return <div>Welcome, {user.name}!</div>;
}

Why Pubflow?

🚀 Build in Record Time

Traditional approach:

Week 1-2: Build authentication system
Week 3-4: Build session management
Week 5-6: Build security layers
Week 7-8: Build caching system
Week 9-10: Build your actual features

Pubflow approach:

Day 1: Sign up at pubflow.com
Day 1: Connect Flowfull backend
Day 1: Start building features

⚡ Infinitely Scalable

┌─────────────────────────────────────────────────────────┐
│              PUBFLOW LOAD BALANCER                       │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────┐│
│  │ Flowfull │  │ Flowfull │  │ Flowfull │  │ Flowfull││
│  │Instance 1│  │Instance 2│  │Instance 3│  │Instance N││
│  └──────────┘  └──────────┘  └──────────┘  └─────────┘│
│       │             │             │             │       │
│       └─────────────┴─────────────┴─────────────┘       │
│                         │                               │
│                    ┌────▼────┐                          │
│                    │  Redis  │  (Shared Cache)          │
│                    └─────────┘                          │
│                                                          │
└─────────────────────────────────────────────────────────┘

• Stateless design - No session affinity required
• Horizontal scaling - Add instances as needed
• Shared cache - Redis for cross-instance caching
• Load balancing - Automatic traffic distribution
• No limits - Scale to millions of users

🔐 Enterprise Security

• 6-layer validation - Comprehensive security checks
• PASETO tokens - Modern cryptographic tokens (Ed25519)
• Bridge validation - Secure session validation
• Configurable modes - STANDARD, ADVANCED, STRICT
• Zero trust - Validate every request

🌍 Language Agnostic

Build Flowfull in any language:

• Node.js/TypeScript - Bun, Node.js, Deno
• Go - High performance, compiled
• Python - FastAPI, Django, Flask
• Rust - Maximum performance and safety

All implementations share the same core concepts!

Getting Started with Pubflow

Step 1: Create Flowless Instance

1. Visit pubflow.com
2. Sign up for an account
3. Create a new Flowless instance
4. Copy your Bridge Secret

Step 2: Build Your Flowfull Backend

1. Choose your language (Node.js, Go, Python, Rust)
2. Follow the Getting Started guide
3. Configure Bridge Validation
4. Build your APIs

Step 3: Connect Your Frontend

1. Install Flowfull-Client library
2. Configure with your Flowfull backend URL
3. Use pre-built auth components
4. Build your UI

Next Steps

Ready to start building?

Get Started →30-Minute Tutorial →

Learn More

• 📖 Core Concepts - Deep dive into architecture
• 🚀 Quick Start - Build your first backend
• 🌐 Pubflow Website - Official website
• 📧 Email: support@pubflow.com