Flowless

Appearance

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

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:

RegionLocationBest For
us_eastVirginia, USANorth America
us_westCalifornia, USAWest Coast USA
eu_westIrelandEurope
eu_centralFrankfurt, GermanyCentral Europe
ap_southeastSingaporeAsia Pacific
ap_northeastTokyo, JapanEast Asia

Multi-Region & Custom Deployments

Flowless can be deployed across multiple regions simultaneously with automatic load balancing for global applications. Need a specific region not listed? Contact us to request a new region deployment or discuss custom infrastructure requirements. There are no limits - we can deploy Flowless wherever your users are.

📧 Contact Support for multi-region or custom deployments.

WARNING

Region cannot be changed after creation. Choose carefully! (Create new deployment)

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

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 your configuration
  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:

bash
# 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) ​

bash
# 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) ​

bash
# 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

"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? ​