CR8 Platform

Appearance

Vercel Projects Summary ​

Overview ​

The CR8 monorepo has two separate Vercel projects for different purposes:

  1. DApp → testnet.createprotocol.org
  2. Docs Website → docs.createprotocol.org

Project 1: DApp (testnet.createprotocol.org) ​

Vercel Project Details ​

  • Project Name: kcolbchains-projects/dapp
  • Project ID: prj_rpktE967bbTXaWjgdaqLgREC8N7V
  • Custom Domain: testnet.createprotocol.org ✅
  • Temp URL: https://dapp-*.vercel.app
  • Package: packages/dapp
  • Root Directory: . (repository root)

Configuration ​

  • Build Command: npm run build --workspace=packages/dapp
  • Output Directory: packages/dapp/.next
  • Framework: Next.js
  • Install Command: npm install

Vercel Dashboard ​

Status ​

✅ Already configured and deployed ✅ Custom domain testnet.createprotocol.org is active

Project 2: Docs Website (docs.createprotocol.org) ​

Vercel Project Details ​

  • Project Name: kcolbchains-projects/website
  • Custom Domain: docs.createprotocol.org (to be added)
  • Temp URL: https://website-delta-bice.vercel.app
  • Package: packages/website
  • Root Directory: . (repository root) ⚠️ Must be set

Configuration ​

  • Build Command: npm run build --workspace=packages/website
  • Output Directory: packages/website/out
  • Framework: Next.js (static export)
  • Install Command: npm install

Vercel Dashboard ​

Status ​

✅ Project exists ⚠️ Needs Root Directory verification ⚠️ Custom domain docs.createprotocol.org needs to be added

Key Differences ​

FeatureDAppDocs Website
Domaintestnet.createprotocol.orgdocs.createprotocol.org
Packagepackages/dapppackages/website
Output.next (SSR)out (static export)
PurposeBlockchain DAppDocumentation site
Status✅ Live⚠️ Needs setup

Setup Checklist for Docs Website ​

Step 1: Verify Vercel Settings ​

Step 2: Deploy and Test Temp URL ​

  • [ ] Deploy to get temp URL (or use existing: https://website-delta-bice.vercel.app)
  • [ ] Test temp URL works correctly
  • [ ] Verify all pages load

Step 3: Add Custom Domain ​

Step 4: Configure DNS ​

  • [ ] Go to DNS provider for createprotocol.org
  • [ ] Add CNAME record:
    • Name: docs
    • Value: cname.vercel-dns.com (or what Vercel shows)
  • [ ] Wait for DNS propagation (5-60 minutes)

Step 5: Verify Domain ​

Important Notes ​

Root Directory Setting ​

Both projects MUST have Root Directory set to . (repo root) because:

  • They use npm workspace commands (--workspace=packages/...)
  • Workspace commands only work when run from repo root
  • If set to package directory, workspace commands fail

Separate Projects ​

  • Each project is completely independent
  • They can be deployed separately
  • They have separate build configurations
  • They have separate custom domains

Root vercel.json ​

The root vercel.json is currently configured for the DApp. This is fine because:

  • Each Vercel project has its own settings in the dashboard
  • The packages/website/vercel.json will be used for the website project
  • Dashboard settings override file settings

DApp ​

Docs Website ​

Troubleshooting ​

"No workspaces found" error ​

Solution: Set Root Directory to . in Vercel dashboard

Build fails ​

Solution:

  1. Verify Root Directory is .
  2. Check build command uses --workspace=packages/website
  3. Verify output directory is packages/website/out

Domain not working ​

Solution:

  1. Check DNS records are correct
  2. Wait for DNS propagation
  3. Verify domain is added in Vercel dashboard
  4. Check SSL certificate status

CR8 Platform Documentation

Copyright © 2024 CR8 Platform