Hackathon New Service Instructions

Step 0. Install Prerequisites

  1. Install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Install dependencies via Homebrew:
brew install gh awscli witco-oss/witco/witco-cli
  1. Set up local AWS and Claude Code config with the Witco CLI:
witctl config generate

Step 1. Start with a template repo

Use the cincpro/template-app-nextjs template for web applications with user-facing experiences.

Click this link to start a repo from the Next.js template.

Use the cincpro/template-app-hono template for services that do not have a user-facing experience, e.g. REST APIs, Prosody workers, etc.

Click this link to start a repo from the Hono template.

Step 2. Configure the template

After creating the project repo and cloning it, execute pnpm run configure to run the setup tool. Accept the defaults for all questions.

Step 3. Request datastore

Available stores: Postgres, Valkey (Redis), S3:

Postgres and Valkey (Redis)

Ask Lars to provision the database for you. It takes about 5 minutes.

S3

The template apps will have permission to use a prd-devcon-witco S3 bucket. You should store your files in a toplevel directory named for your app, e.g. s3://prd-devcon-witco/my-great-app/*.

Step 4. Log into ECR

Neceessary to allow your local Docker client to pull the base images to build your app's container.

aws ecr get-login-password --region us-east-1 --profile witco-mgt | \
  docker login --username AWS --password-stdin 558529356944.dkr.ecr.us-east-1.amazonaws.com

Step 5. Generate GH auth token for Packages

gh auth login -s read:packages
gh auth token

Put this token into the .env file in your project as GH_PACKAGES_READ_TOKEN.