Installation & Deployment Guide

Overview

Your download is a full Next.js project with a Prisma database, API routes, Radix wallet authentication, and a store with checkout. You'll need four services:

1. GitHub (private repo) — hosts your source code
2. Supabase (free tier) — PostgreSQL database
3. Vercel (free tier) — builds and hosts your site
4. Vercel Blob Storage — stores uploaded images

1. Open your site in the Builder and make all your edits.
2. Click the Download (1,000 XRD) button in the top toolbar.
3. Approve the payment in your Radix Wallet.
4. A .zip file will be downloaded automatically.
5. Unzip it anywhere on your computer.

Your .zip contains a complete Next.js application:

1. Go to github.com/new and create a private repository (any name you like, no template, no README).
2. Open a terminal in your unzipped project folder and run:

1. Sign up at supabase.com and create a new project. Choose a strong database password and save it somewhere safe.
2. Once the project is ready, go to Project Settings → Database.
3. Scroll down to Connection string and select the URI tab.
4. Copy the Session pooler connection string (port 5432). It looks like:
   postgresql://postgres.XXXX:[YOUR-PASSWORD]@aws-0-region.pooler.supabase.com:5432/postgres
5. Replace [YOUR-PASSWORD] with the database password you chose when creating the project.

Vercel Blob stores the images uploaded through your site (product photos, block images, logos, etc.).

1. Go to vercel.com and sign up (or log in) with your GitHub account.
2. From the Vercel dashboard, click Storage in the top navigation.
3. Click Create Store → select Blob → give it a name (e.g. my-site-images) → click Create.
4. Once created, the store page will show your BLOB_READ_WRITE_TOKEN. Copy this value.

Your project includes a .env file with placeholder values. Open it in any text editor and fill in each value:

Required Variables

Radix Wallet Variables

Site Identity

Asset Prices (pre-filled)

With your .env file configured, set up the database and start the dev server:

Open http://localhost:3000 to see your site running locally.

1. Go to vercel.com/new and click Import next to your GitHub repository.
2. Under Environment Variables, add every variable from your .env file. You can paste them all at once — Vercel will parse them automatically.

   Make sure to update NEXT_PUBLIC_APP_URL to your Vercel deployment URL (e.g. https://your-site.vercel.app) instead of localhost:3000.

3. Leave the Framework Preset as Next.js (Vercel auto-detects it).
4. Click Deploy. Vercel will install dependencies, run prisma generate, and build your site.
5. Once the build is complete, your site is live at https://your-project.vercel.app.

Link Blob Storage to the Project

If you created your Blob store before importing the project, link it now:

1. In the Vercel dashboard, open your project → Storage tab.
2. Click Connect Store → select the Blob store you created in Step 5.
3. This automatically injects the BLOB_READ_WRITE_TOKEN environment variable into your project's deployments.

1. Purchase a domain from any registrar (Namecheap, Cloudflare, GoDaddy, etc.).
2. In your Vercel project, go to Settings → Domains and add your domain.
3. Vercel will show you the DNS records to add. Go to your registrar's DNS settings and add them:
   • For a root domain (e.g. example.com): add an A record pointing to 76.76.21.21
   • For a subdomain (e.g. www.example.com): add a CNAME record pointing to cname.vercel-dns.com
4. Wait for DNS propagation (usually a few minutes, up to 48 hours). Vercel will automatically provision an SSL certificate.
5. Once live, update NEXT_PUBLIC_APP_URL in your Vercel environment variables to match your new domain, then redeploy.

Updating Your Site

After the initial deployment, the workflow is simple:

1. Make code changes locally and test with npm run dev.
2. Commit and push to GitHub:

Vercel automatically detects the push and redeploys your site within about a minute.

Things to Know

• Product images uploaded via the builder reference their Vercel Blob URLs and will continue to work as long as your Blob store is active.
• Asset prices are fetched live from OciSwap — they update automatically.
• RSS feeds are fetched server-side and always show current content.
• Store checkout works fully via the Radix wallet — no additional payment provider needed.
• You can re-download your site at any time after making changes in the builder (each download costs 1,000 XRD).
• The seed script is idempotent — running it again will re-create your pages and products (it deletes existing ones first).