AI Starter

A Next.js starter project with Supabase for authentication and database, built for the AI workshop.

Prerequisites

Before the workshop, make sure you have the following installed and configured.

1. Homebrew

Homebrew is a package manager for macOS that you'll use to install several other tools. Install it if you don't have it:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Git

Your Mac may not have git available by default. Install it via Homebrew:

brew install git

3. Code Editor

A code editor will make things much easier. Cursor is recommended, but any editor works (VS Code, Zed, etc.).

4. Node.js 22

Install nvm (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Restart your terminal, then install and activate Node 22:

nvm install 22 && nvm use 22 && node --version

5. pnpm

pnpm is a fast package manager you'll use to install dependencies and add functionality to your app. Follow the instructions at https://pnpm.io/installation

6. Docker Desktop

Download and install Docker Desktop for Mac. This is needed to run Supabase locally.

7. Supabase CLI

Install the Supabase CLI via Homebrew:

brew install supabase/tap/supabase

8. Claude Code CLI

Install the Claude Code CLI:

curl -fsSL https://claude.ai/install.sh | bash

9. GitHub Desktop

Download and install GitHub Desktop.

Getting Started

Once all prerequisites are installed, clone the repo, detach it from the original remote, and install dependencies:

git clone <repo-url>
cd ai-starter
git remote remove origin
pnpm install

Important: You must run git remote remove origin to disconnect from the shared starter repo. This prevents accidental pushes.

Tech Stack

• Next.js 16
• React 19
• Supabase (auth & database)
• Tailwind CSS 4
• shadcn/ui components
• TypeScript