Seamless Full-Stack: RedwoodJS & Fly.io for Global Apps

Modern web development demands robust, scalable, and globally distributed applications. Combining the full-stack power of RedwoodJS with the global reach of Fly.io offers an exceptional solution for building and deploying high-performance TypeScript applications. This guide demonstrates how to integrate these two powerful platforms.

Why RedwoodJS?

RedwoodJS is an opinionated, full-stack framework that brings together React, GraphQL, Prisma, and TypeScript into a cohesive development experience. It accelerates development by providing a convention-over-configuration approach, robust tooling, and a complete development workflow from frontend to backend. RedwoodJS Documentation

npx create-redwood-app my-global-app --typescript
cd my-global-app
yarn install

Why Fly.io?

Fly.io is a global application platform designed to run your Docker containers close to your users, minimizing latency and maximizing performance. It simplifies infrastructure management, offering managed services like PostgreSQL and seamless scaling, making it ideal for deploying full-stack applications with ease. Fly.io Documentation

Setting Up Your RedwoodJS Project

After creating your RedwoodJS project, you'll typically start development locally. RedwoodJS provides a streamlined development server that handles both your API and web services.

yarn redwood dev

Database with Prisma and Fly Postgres

RedwoodJS leverages Prisma as its ORM, providing type-safe database interactions and powerful migration capabilities. Fly.io offers managed PostgreSQL instances, which integrate perfectly with Redwood's backend. First, define a simple schema:

// api/db/schema.prisma

model Post {
  id        String   @id @default(uuid())
  title     String
  body      String
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

Then, generate your Prisma client and a migration:

yarn rw prisma migrate dev --name create-post

Preparing for Fly.io Deployment

RedwoodJS provides excellent out-of-the-box support for Fly.io. The setup deploy fly command automates the creation of necessary deployment files, including a fly.toml configuration and a production-ready Dockerfile.

yarn redwood setup deploy fly

This command will guide you through setting up your Fly.io application and provisioning a PostgreSQL database.

Deploying Your Application to Fly.io

With the setup complete, you can now launch and deploy your application. The fly launch command initializes your Fly.io app, and fly deploy pushes your container image to their global network.

fly launch
# Follow prompts: app name, region, PostgreSQL setup

# Deploy your application
fly deploy

After deployment, you must run any pending Prisma database migrations on your remote instance. This ensures your database schema matches your application's expectations.

fly ssh console -C "yarn rw prisma migrate deploy"

Environment Variables and Secrets

Managing sensitive information like DATABASE_URL is crucial. Fly.io provides a secure way to set environment variables and secrets for your application. RedwoodJS will automatically pick up the DATABASE_URL for Prisma.

fly secrets set DATABASE_URL="<your-fly-postgres-connection-string>"

Best Practices for Production

• CI/CD Integration: Automate your deployments by integrating fly deploy into your CI/CD pipeline (e.g., GitHub Actions or GitLab CI/CD). This ensures consistent and reliable releases on every code push.
• Observability: Leverage Fly.io's built-in logging and monitoring tools. Combine this with RedwoodJS's robust logging capabilities to gain deep insights into your application's performance, errors, and overall health in production.
• Scaling: Easily scale your application horizontally on Fly.io to handle increased traffic. Use fly scale count <N> for your web and API services, and fly scale memory <MB> for resource allocation.
• Health Checks: Ensure your fly.toml includes appropriate health checks for your web and API services to allow Fly.io to intelligently manage traffic and restarts.

Conclusion

Integrating RedwoodJS with Fly.io provides a powerful, type-safe, and globally distributed stack for modern web applications. From rapid development with Redwood's full-stack features to seamless, low-latency deployment on Fly.io, this combination empowers developers to build and scale ambitious projects efficiently. Embrace this synergy to deliver exceptional user experiences worldwide.