Skip to main content
Step-by-step guide for deploying GoodCraft Script to Render.

​
Prerequisites

  • GitHub repository with render.yaml committed
  • Clerk account with API keys
  • (Optional) BetterStack account for logging

​
Step 1: Create Blueprint

1

Open Render Dashboard

Go to dashboard.render.com.
2

Create a new Blueprint

Click New > Blueprint.
3

Connect GitHub

Connect your GitHub account if not already connected.
4

Select repository

Select the goodcraft-script repository. Render auto-detects render.yaml.
What gets created:
ServiceTypeCost
goodcraft-scriptWeb Service (Starter)$7/mo
goodcraft-script-dbPostgreSQL (Basic-256mb)$6/mo

​
Step 2: Configure secrets

Before clicking “Apply”, you’ll be prompted for environment variables marked sync: false.
VariableWhere to get it
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYClerk Dashboard > API Keys
CLERK_SECRET_KEYClerk Dashboard > API Keys
LOGTAIL_SOURCE_TOKENBetterStack Logs > Sources (optional)
DATABASE_URL is automatically injected from the linked PostgreSQL database. You don’t need to configure it manually.

​
Step 3: Deploy

1

Apply the Blueprint

Click Apply to start deployment.
2

Monitor the build

Watch the build logs for any errors.
3

Wait for health check

The deployment completes when /api/health responds successfully.
Your app is live at https://goodcraft-script.onrender.com

​
Step 4: Initialize database

After the first successful deploy, push the database schema.

​
Step 5: Configure Clerk

Update Clerk to allow your Render domain:
1

Open Clerk Dashboard

Go to Clerk Dashboard.
2

Select your application

Choose the application you’re using for GoodCraft Script.
3

Add allowed origin

Go to Settings > Paths (or Domains) and add:
https://goodcraft-script.onrender.com
Users won’t be able to sign in until Clerk recognizes your Render domain.

​
Step 6: Custom domain (optional)

1

Add domain in Render

Go to Web Service > Settings > Custom Domains and add your domain.
2

Configure DNS

Add a CNAME record to your DNS:
CNAME  app  goodcraft-script.onrender.com
3

Wait for SSL

SSL certificate provisioning takes approximately 10 minutes.
4

Update Clerk

Add your custom domain to Clerk’s allowed origins.

​
Post-setup checklist

  • App loads at Render URL
  • Health check passes: curl https://goodcraft-script.onrender.com/api/health
  • Can sign in via Clerk
  • Database has schema
  • Auto-deploy works (push to production branch)
  • (Optional) Custom domain configured
  • (Optional) BetterStack logs flowing

​
Ongoing costs

ServicePlanMonthly
Web ServiceStarter$7
PostgreSQLBasic-256mb$6
Total$13
Plan specs:
  • Web: 512 MB RAM, 0.5 CPU
  • DB: 256 MB RAM, 0.1 CPU, 1 GB storage (expandable)
Upgrade paths available if needed.