Creating a Flowless Instance

Learn how to create and configure your first Flowless instance on Pubflow.com in just a few minutes.

---

Prerequisites

Before creating a Flowless instance, you'll need:

• A Pubflow account (Sign up here)
• Basic understanding of your application's requirements
• Payment method (for paid plans, free plan available)

---

Step 1: Access the Pubflow Dashboard

1. Log in to Pubflow.com
2. Navigate to the Dashboard
3. Click on "Create New Instance" or "New Service"

---

Step 2: Select Flowless

1. From the service selection screen, choose Flowless
2. You'll see a brief description of what Flowless provides
3. Click "Continue" to proceed with configuration

---

Step 3: Configure Your Instance

Basic Configuration

Instance Name

• Choose a unique, descriptive name
• This will be part of your instance URL
• Examples: my-app-auth, production-auth, staging-auth
• URL Format: https://your-instance-name.pubflow.com

Instance Name: my-app-auth
Instance URL:  https://my-app-auth.pubflow.com

TIP

Use different instances for different environments:

• my-app-dev for development
• my-app-staging for staging
• my-app-prod for production

Region Selection

Choose the region closest to your users for optimal performance:

Region	Location	Best For
us-east-1	Virginia, USA	North America
us-west-1	California, USA	West Coast USA
eu-west-1	Ireland	Europe
eu-central-1	Frankfurt, Germany	Central Europe
ap-southeast-1	Singapore	Asia Pacific
ap-northeast-1	Tokyo, Japan	East Asia

WARNING

Region cannot be changed after creation. Choose carefully!

Plan Selection

Choose a plan based on your needs:

Free Plan

• Users: Up to 1,000 monthly active users
• Sessions: Unlimited
• API Calls: 100,000/month
• Email: 1,000 emails/month
• Support: Community support
• Best For: Development, small projects, testing

Pro Plan ($29/month)

• Users: Up to 10,000 monthly active users
• Sessions: Unlimited
• API Calls: 1,000,000/month
• Email: 10,000 emails/month
• Support: Email support (24h response)
• Features: Custom domain, advanced analytics
• Best For: Growing applications, startups

Enterprise Plan (Custom pricing)

• Users: Unlimited
• Sessions: Unlimited
• API Calls: Unlimited
• Email: Unlimited (or custom SMTP)
• Support: Priority support (4h response)
• Features: SLA, dedicated infrastructure, custom integrations
• Best For: Large applications, enterprises

---

Step 4: Initial Settings

Database Selection

Flowless automatically provisions a database for you. Choose your preferred database:

• PostgreSQL (Recommended) - Best performance and features
• MySQL - Wide compatibility
• LibSQL - Serverless, edge-optimized
• SQLite - Lightweight, file-based (Free plan only)

TIP

PostgreSQL is recommended for production use due to better performance and feature support.

Security Settings

Session Duration

• Default: 7 days
• Range: 1 hour to 30 days
• Recommendation: 7 days for web, 30 days for mobile

Email Verification

• Required: Users must verify email before login
• Optional: Users can login without verification
• Disabled: No verification emails sent

Password Requirements

• Minimum Length: 8-32 characters (default: 8)
• Require Uppercase: Yes/No (default: Yes)
• Require Numbers: Yes/No (default: Yes)
• Require Special Characters: Yes/No (default: Yes)

---

Step 5: Review and Create

1. Review all your settings
2. Confirm the plan and pricing
3. Click "Create Instance"

Provisioning

The instance creation process takes approximately 30-60 seconds:

✓ Creating database...
✓ Provisioning servers...
✓ Configuring security...
✓ Setting up email service...
✓ Generating credentials...
✓ Instance ready!

---

Step 6: Get Your Credentials

Once created, you'll receive:

Instance URL

https://your-instance-name.pubflow.com

Bridge Secret

bridge_secret_abc123xyz789

DANGER

Keep your Bridge Secret secure!

• Never commit it to version control
• Store it in environment variables
• Rotate it regularly
• Use different secrets for dev/staging/prod

Admin API Key (Optional)

admin_key_def456uvw012

---

Step 7: Test Your Instance

Verify your instance is working:

# Health check
curl https://your-instance-name.pubflow.com/test/health

# Expected response
{
  "success": true,
  "data": {
    "status": "healthy",
    "version": "1.0.0",
    "uptime": 123
  }
}

---

Step 8: Configure Environment Variables

Add these to your application:

Frontend (.env)

# Flowless instance URL
VITE_FLOWLESS_URL=https://your-instance-name.pubflow.com
# or for Next.js
NEXT_PUBLIC_FLOWLESS_URL=https://your-instance-name.pubflow.com
# or for Expo
EXPO_PUBLIC_FLOWLESS_URL=https://your-instance-name.pubflow.com

Backend (.env)

# Flowless instance URL
FLOWLESS_URL=https://your-instance-name.pubflow.com

# Bridge Secret (KEEP SECURE!)
BRIDGE_SECRET=bridge_secret_abc123xyz789

# Validation mode (STANDARD, ADVANCED, STRICT)
VALIDATION_MODE=STANDARD

---

Next Steps

Now that your instance is created:

1. Configure Your Instance - Set up email, OAuth, etc.
2. Environment Variables - Complete environment setup
3. Make Your First API Call - Test the API
4. Integrate Your Backend - Connect Flowfull

---

Common Issues

"Instance name already taken"

• Choose a different, unique name
• Instance names are globally unique across all Pubflow users

"Payment method required"

• Free plan doesn't require payment
• Pro/Enterprise plans require a valid payment method
• Add payment method in Account Settings

"Region unavailable"

• Some regions may be temporarily unavailable
• Choose an alternative region
• Contact support for region-specific requirements

---

Managing Your Instance

Viewing Instance Details

1. Go to Pubflow Dashboard
2. Click on your instance name
3. View URL, status, usage, and settings

Deleting an Instance

DANGER

Deleting an instance is permanent and cannot be undone!

1. Go to Instance Settings
2. Scroll to "Danger Zone"
3. Click "Delete Instance"
4. Type instance name to confirm
5. All data will be permanently deleted

---

Need Help?

• 📚 Configuration Guide
• 💬 Community Forum
• 📧 Support