Flowfull Docs

Appearance

Introduction to Flowfull ​

Welcome to Flowfull - the fastest way to build production-ready backends with the Pubflow architecture!

What is Flowfull? ​

Flowfull is your custom backend layer that connects to Pubflow for authentication. It's designed to help you build scalable, secure backends in record time by providing:

  • ✅ Pre-built authentication - No need to build login, registration, sessions
  • ✅ Trust-based validation - Secure session validation with Bridge Validation
  • ✅ Advanced caching - 3-tier HybridCache for lightning-fast performance
  • ✅ Multi-database support - PostgreSQL, MySQL, LibSQL/Turso
  • ✅ Language agnostic - Portable concepts for Node.js, Go, Python, Rust
  • ✅ Language agnostic - Portable concepts for any language
  • ✅ Production ready - Battle-tested patterns and security

The Pubflow Ecosystem ​

Flowfull is part of a complete architecture:

The Three Layers ​

  1. 🔐 Flowless - Core authentication backend

    • Deployed on Pubflow
    • Handles all authentication (login, registration, sessions)
    • Managed service - no setup required
    • Validates sessions for your Flowfull backend

  2. ⚡ Flowfull - Your custom backend (this documentation)

    • Connects to Flowless via Bridge Validation
    • Implements your business logic and APIs
    • Manages your database and cache
    • Stateless and horizontally scalable

  3. 🎨 Flowfull-Client - Your frontend

    • React, Next.js, React Native, or any framework
    • Connects to your Flowfull backend
    • Uses Pubflow authentication seamlessly

Why Flowfull? ​

🚀 Build in Record Time ​

Instead of spending weeks building authentication, validation, and security:

typescript
// Traditional approach (weeks of work)
- Build user registration ❌
- Build login system ❌
- Build session management ❌
- Build password reset ❌
- Build email verification ❌
- Build security layers ❌
- Build caching system ❌

// Flowfull approach (30 minutes)
import { requireAuth } from './lib/auth/middleware';

app.get('/api/profile', requireAuth(), async (c) => {
  const userId = c.get('user_id');  // ✅ Done!
  return c.json({ profile: await getProfile(userId) });
});

⚡ Lightning Fast Performance ​

3-tier HybridCache system:

  • 97% cache hit rate in production
  • 50x faster responses (1-2ms vs 50ms)
  • Automatic fallback (LRU → Redis → Database)
  • Horizontal scaling with shared Redis cache

🔐 Enterprise Security ​

6-layer security validation:

  1. PASETO signature verification (Ed25519)
  2. Expiration check
  3. Redis status check
  4. Database status check
  5. User ownership validation
  6. Resource validation

🌍 Language Agnostic ​

Portable concepts that work in any language:

Official SDKs are separate from starter templates:

Flowfull is your custom backend layer: keep your language, your framework, and your architecture while standardizing auth/bridge validation.

Core Concepts ​

Flowfull is built on 7 portable concepts:

  1. Bridge Validation - Distributed authentication
  2. Validation Modes - Layered security
  3. HybridCache - 3-tier caching
  4. Trust Tokens - PASETO tokens
  5. Auth Middleware - Route protection
  6. Multi-Database - Database abstraction
  7. Environment Config - Configuration management

Real-World Usage ​

Flowfull concepts are used in many production systems worldwide:

  • Gaming platforms - High-traffic applications with millions of requests per day
  • SaaS applications - Multi-tenant systems with complex authentication
  • E-commerce platforms - Payment processing and order management
  • Enterprise systems - Internal tools and business applications

Next Steps ​

Ready to build your first Flowfull backend?

Get Started →30-Minute Tutorial →

Questions? ​

Need Professional Help? ​

If you need assistance, professional support, or want us to build your backend for you:

  • 🌐 Notside.com - Technology firm specializing in Pubflow implementations
  • 📧 Email: [email protected]
  • 💼 Services: Custom backend development, consulting, and enterprise support