Tinkerer Pattern

fjall create app --type tinkerer

┌─────────────────────┐
│  ECS on EC2         │
│  (t4g.micro)        │ Direct port mapping (no ALB)
│  Memory: 400 MiB    │
└────────┬────────────┘
         |
┌────────┴────────┐
│  RDS Instance   │ (t4g.micro, free tier eligible)
└─────────────────┘

#!/usr/bin/env node

import {
  App,
  DatabaseFactory,
  ComputeFactory,
  getConfig,
} from "@fjall/components-infrastructure";

const appName = "experiment";
const app = App.getApp(appName);

app.addTags({
  "fjall:costAllocation:owner": "engineering",
});

const experimentStorage = app.addDatabase(
  DatabaseFactory.build("ExperimentStorage", {
    type: "Instance",
    databaseName: "ExperimentDatabase",
    instanceType: "t4g.micro", // Free tier eligible
    allocatedStorage: 20, // Free tier: up to 20 GB
  }),
);

app.addCompute(
  ComputeFactory.build("ExperimentCompute", {
    type: "ecs",
    ecrRepository: app.getDefaultContainerRegistry(),
    cluster: {
      directAccess: true, // No ALB, direct port mapping
    },
    services: [
      {
        name: "app",
        capacityProvider: "EC2",
        memoryLimitMiB: 400,
        containers: [
          {
            port: 3000,
            environment: {
              ENVIRONMENT: getConfig().environment,
              DATABASE_HOST: experimentStorage.getHostEndpoint(),
              DATABASE_PORT: `${experimentStorage.getHostPort()}`,
              DATABASE_NAME: experimentStorage.getDatabaseName(),
            },
            secretsImport: {
              DATABASE_PASSWORD: experimentStorage
                .getCredentials()
                .getImport("password"),
            },
          },
        ],
      },
    ],
  }),
);

app.addCompute(
  ComputeFactory.build("ExperimentCompute", {
    type: "ecs",
    cluster: {
      directAccess: true,
    },
    services: [
      {
        name: "app",
        capacityProvider: "EC2",
        memoryLimitMiB: 400,
        containers: [
          {
            environment: {
              NODE_ENV: "development",
              API_KEY: "dev-key-123",
              FEATURE_FLAGS: "experimental",
            },
          },
        ],
      },
    ],
  }),
);

fjall add compute --app experiment --name Worker --type lambda

# Move to a Lightweight pattern with Fargate
fjall create app --name production --type lightweight

# Create a production app with the Standard pattern
fjall create app --name production --type standard
# Migrate data and switch traffic

version: "3.8"
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_HOST=db
      - DATABASE_PORT=5432
      - DATABASE_NAME=experiment
      - DATABASE_PASSWORD=localpass
    depends_on:
      - db

  db:
    image: postgres:17-alpine
    environment:
      - POSTGRES_DB=experiment
      - POSTGRES_PASSWORD=localpass