Quick Start

Deployment Options#

The Temp-Number App supports multiple deployment strategies to fit different use cases.

Comparison Table#

Deployment Paths#

1. ⚡ Setup Wizard (Recommended)#

Best for: All users, especially first-time deployments

The interactive setup wizard guides you through the entire deployment process:

• Validates prerequisites
• Collects configuration interactively
• Configures Firebase and cloud resources
• Deploys to your chosen platform (Local Docker or Google Cloud)
• Provides post-deployment instructions

Command:

git clone https://github.com/platfone-com/temp-number-deploy.git
cd temp-number-deploy
./setup-wizard.sh

Learn more: Setup Wizard Guide →

2. Local Docker Compose#

Best for: Development, testing, and evaluation

Run the complete stack on your local machine using Docker Compose:

• ✅ Quick setup (5-10 minutes)
• ✅ No cloud costs
• ✅ Full development environment
• ⚠️ Not suitable for production
• ⚠️ Limited to local access

Use cases:

• Testing the platform before production deployment
• Local development and customization
• Training and demonstrations

Learn more: Local Docker Guide →

3. Google Cloud Platform#

Best for: Production deployments with automatic scaling

Deploy to Google Cloud Run with Cloud SQL for a fully managed, production-ready setup:

• ✅ Automatic HTTPS with managed certificates
• ✅ Auto-scaling based on traffic
• ✅ Managed database backups
• ✅ Global CDN and load balancing
• ⚙️ Seamless CI/CD and monitoring integration
• 💰 Pay-as-you-go pricing (~$20-100/month)

Architecture:

• Backend: Cloud Run container
• Database: Cloud SQL (MySQL)
• Frontend: Cloud Run container with Nginx
• SSL: Google-managed certificates
• DNS: Cloud DNS or external provider

Learn more: Google Cloud Guide →

4. Manual Setup#

Best for: Custom infrastructure or specific requirements

Deploy to your own infrastructure with full control:

• ✅ Complete flexibility
• ✅ Use any cloud provider or on-premises
• ✅ Custom security configurations
• ⚠️ Requires DevOps expertise
• ⚠️ Manual scaling and maintenance

Supported platforms:

• AWS (EC2, RDS, ECS)
• Azure (Container Instances, Azure SQL)
• DigitalOcean (Droplets, Managed Databases)
• Self-hosted servers

Decision Tree#

Choose based on your needs:

1. I want to evaluate the platform → Start with Local Docker
2. I need production deployment ASAP → Use Google Cloud with Setup Wizard
3. I have specific infrastructure requirements → Go with Manual Setup
4. I’m not sure what I need → Start with Setup Wizard

What’s Included in All Deployments#

Regardless of your chosen method, you’ll get:

• 🔧 Backend API: Complete AdonisJS backend with all features
• 🖥️ Web Application: Full Vue.js frontend
• 🗄️ Database: MySQL/MariaDB with initial schema
• 🔐 Authentication: Firebase Auth integration
• 💳 Payment Processing: Stripe and other gateways
• 📚 API Documentation: OpenAPI/Swagger UI
• 🔒 Security: CORS, rate limiting, input validation

Prerequisites by Deployment Type#

All Deployments Need#

• Platfone API credentials
• Firebase project (Auth + optional FCM)
• Payment gateway account (Stripe recommended)

Local Docker Needs#

• Docker & Docker Compose installed
• 4GB+ RAM available
• Ports 8080, 3333, 3336 available

Google Cloud Needs#

• Google Cloud account with billing enabled
• gcloud CLI installed and authenticated
• Domain name (optional but recommended)

Manual Setup Needs#

• Server with Node.js 22.x+
• MySQL 8.0+ database
• Nginx or similar reverse proxy
• SSL certificates (Let’s Encrypt recommended)

Cost Estimates#

Local Docker#

• Cost: Free (uses local resources)
• Requirements: Development machine with Docker

Google Cloud (Production)#

Estimated monthly costs for moderate traffic:

Costs scale with traffic. Free tier covers ~2M requests/month.

Manual Setup#

• Infrastructure: $5-100/month (provider dependent)
• Maintenance: Your DevOps time
• Backups: Additional costs may apply

Next Steps#

Ready to deploy? Choose your path: