🕊️Fly.io

Explore FormSG running on Fly.io platform through a live demo and learn about platform adaptation patterns.

Quick Start Prerequisites

Before exploring FormSG on Fly.io:

• Fly.io account with CLI installed (optional - for your own deployment)

• Basic Docker knowledge (helpful for understanding the setup)

FormSG Demo Architecture

This demo shows how FormSG can be adapted for the Fly.io platform:

Fly.io Implementation

FormSG components in this demo setup:

• Application: Single container running on Fly.io infrastructure

• Database: External MongoDB instance

• Object Storage: External storage service

• Email Service: External SMTP provider

• Monitoring: Basic Fly.io platform monitoring

🌟 Live FormSG Demo

Try it now: form.demos.sg - A working FormSG instance you can explore immediately

What the Demo Demonstrates

The FormSG Fly.io demo showcases:

• Platform deployment - FormSG running on Fly.io infrastructure

• Overlay architecture - How to customize FormSG for different contexts

• Platform adaptation - FormSG adapted for container deployment

• Development workflow - Clean development and deployment patterns

• Live example - Working system you can test and explore

Getting Started

Quick Start

Repository: opengovsg/formsg-on-fly

# 1. Clone the template
git clone https://github.com/opengovsg/formsg-on-fly.git
cd formsg-on-fly

# 2. Install dependencies
# Install "just" command runner (macOS)
brew install just

# Or install "just" (other platforms)
# See: https://github.com/casey/just#installation

# 3. Set up the environment
just setup

# 4. Start development server
just start

Local testing: Application runs at http://localhost:5000

Configuration

Deployment

Fly.io Template Documentation

For detailed configuration and advanced features:

• Repository: FormSG on Fly.io

• Live Demo: form.demos.sg

• Fly.io Docs: Platform Documentation

Best For: Learning FormSG capabilities, understanding platform adaptation patterns, or experimenting with your own FormSG instance.

Exploring the Demo

Try the live demo first: Visit form.demos.sg to explore FormSG features

If deploying your own instance:

1. Check deployment: fly status shows healthy instances

2. Test functionality:

   • Login with email OTP

   • Create a test form

   • Submit form as user

Issues? Check fly logs for application logs.

🎉 Success! You've explored FormSG on Fly.io and understand how it can be adapted for different platforms.

Next steps:

• Try the live demo at form.demos.sg

• Explore the overlay architecture in the repository

• Consider how this approach might work for your deployment needs