Project Setup for AI Coders
Skip the boring stuff. Get from idea to working project in 10 minutes flat.
In this chapter
- How to pick the right AI coding tool for your project
- What to install (and what you can skip) for each tool
- How to create your first repo without writing any code
- The perfect first prompt to scaffold your project
Step 1: Decide What You're Building
Before you touch any tool, answer three questions. This is the difference between a 10-minute setup and a 2-hour rabbit hole.
Step 2: Pick Your Tool
There are two big categories. Pick the one that matches how you want to work.
Browser-based (no install)
Open a website, sign up, and you're building in 30 seconds. Best if you're brand new or just want to prototype fast.
- Lovable: full-stack apps with a database and login built in
- Bolt.new: quick prototypes, deploys in one click
- v0 by Vercel: beautiful UI, landing pages, and full apps
- Replit: Agent builds and hosts full apps in the browser
Local (install required)
Runs on your computer. More power, more control, but a little setup. Best for serious projects you plan to ship.
- Claude Code: terminal-based, very capable
- Cursor: full code editor with AI built in
- Devin Desktop (formerly Windsurf): Cursor alternative by Cognition
- GitHub Copilot: suggestions and agent mode inside VS Code and other editors
Step 3: Install What You Need
If you picked a browser tool, skip this section: you don't need anything. If you picked Claude Code or Cursor, here's the minimum.
Step 4: Create the Project
You don't create the project: you ask AI to. Open your tool and paste this prompt:
“I want to start a new project. It will be [one-sentence description of what you're building]. Please: 1. Create a new Next.js project with TypeScript and Tailwind CSS 2. Initialize a git repository 3. Add a sensible .gitignore (Next.js + .env files) 4. Create a single homepage that says "Hello, [project name]" in a centered hero 5. Confirm everything runs by starting the dev server Walk me through any choices I need to make in plain English.”
That's it. In about 30 seconds, you have a working project running on your computer. No reading docs. No copy-pasting commands. No questions about what npm or yarn means.
Step 5: Connect to GitHub
Your project lives on your computer. If your laptop dies, your project dies. Push it to GitHub so it's safe in the cloud.
-
1
Create the repo On GitHub, click "New repository". Give it a name. Leave everything else blank. Click create.
-
2
Copy the URL GitHub shows you a URL ending in .git. Copy it to your clipboard.
-
3
Ask AI to push Paste the URL into your AI tool with the prompt below. AI handles the rest.
“Connect this project to my GitHub repository at [paste your GitHub URL here]. Push the initial commit and confirm it shows up on GitHub. If anything goes wrong, walk me through the fix in plain English.”
Common Gotchas
Things that trip up almost everyone on their first project.
"npm: command not found"
You skipped Node.js. Go install it from nodejs.org, then restart your terminal and try again.
"Permission denied (publickey)" when pushing to GitHub
Use the HTTPS URL from GitHub instead of the SSH URL. The HTTPS URL starts with https://github.com/ (paste that one to AI and ask it to use HTTPS auth).
Project starts but the page is blank
Open the browser's developer console (F12 or Cmd+Option+I). Copy any red error messages and paste them into AI with "help me fix this."
AI keeps trying to use a different framework than you wanted
Be specific in your prompt. Say "use Next.js 16 with the App Router and TypeScript", not just "build me a website."
Real World Example: Setting up your first portfolio project
You want a personal portfolio with a homepage, an about page, and three project cards. Instead of reading 10 tutorials about Next.js, you install Cursor, sign in, and paste one prompt. Two minutes later you have a working site running on your computer with three pages already wired up.
“I'm starting a personal portfolio site. Create a new project for me. Add a homepage with a hero section and three project cards, an /about page with a short bio placeholder, and a navigation bar linking between them. Set it up so I can save versions with Git and back it up on GitHub later, and start the local preview so I can see the site in my browser.”
Prompt This
Three prompts that handle the most common setup tasks.
“Add [tool name, e.g., Stripe / Supabase / Resend] to my project. Do the full setup, put placeholder keys in the safe spot where secrets go, and walk me through where to get the real keys from that tool's website.”
“I started this project in [old tool] and I want to continue it in [new tool]. Make sure my git history is intact, the code still runs, and everything is configured properly for the new tool.”
“I want to start from a Next.js + Supabase + Tailwind starter template. Find a good free one (like the Vercel + Supabase starter), clone it, install dependencies, and get it running locally. Explain what each main folder does.”
Frequently Asked Questions
Do I need to install anything before I start?
It depends on the tool. Browser-based tools like Lovable, Bolt.new, and v0 need nothing: just sign up and start. Local tools like Claude Code and Cursor need an installer, plus Node.js to run the project on your computer. The chapter walks you through both paths.
What is a 'repo' and do I need one?
A repo (short for repository) is a folder that Git tracks. Yes, you need one: without a repo, you cannot save your work, undo mistakes, or deploy. The good news: most AI tools create one for you automatically when you make a new project.
Should I create the project or let AI do it?
Let AI do it. If you try to create the folders and config files yourself, you will spend an hour reading docs. If you ask AI 'create a new Next.js project with Tailwind and Supabase,' it does the whole thing in 30 seconds.
What is the first prompt I should write?
Describe what you want to build in one or two sentences, then ask AI to scaffold the structure. Example: 'I want to build a personal portfolio site with a homepage, an about page, and a contact form. Set up the project with Next.js and Tailwind, and create empty versions of those three pages.'