Module 3: Working with ProjectsLesson 1 of 6
0%
Lesson 1ยท3 min

Creating a Project Folder

Set up a proper project structure

Creating a Project Folder

Good project structure helps both you and Claude. Let's set up a project properly.

Starting Fresh

Terminal
$ cd ~/projects # or wherever you keep projects
$ mkdir my-saas-app
$ cd my-saas-app
โ–Œ

Initialize Git (Important!)

Terminal
$ git init
Initialized empty Git repository in /Users/john/projects/my-saas-app/.git/
โ–Œ

Tip

Always use git! It's your safety net. If Claude makes a mistake, you can easily revert.

Create Core Files

Terminal
# Project documentation
$ touch README.md
$ touch CLAUDE.md
# Git ignore file
$ touch .gitignore
# Check structure
$ ls -la
total 0
drwxr-xr-x 6 john staff 192 Apr 30 10:00 .
drwxr-xr-x 5 john staff 160 Apr 30 09:00 ..
drwxr-xr-x 9 john staff 288 Apr 30 10:00 .git
-rw-r--r-- 1 john staff 0 Apr 30 10:00 .gitignore
-rw-r--r-- 1 john staff 0 Apr 30 10:00 CLAUDE.md
-rw-r--r-- 1 john staff 0 Apr 30 10:00 README.md
โ–Œ

Initial .gitignore

Terminal
$ cat > .gitignore << 'EOF'
node_modules/
.env
.env.local
.DS_Store
*.log
dist/
build/
EOF
โ–Œ

Warning

Never commit .env files with secrets! The .gitignore protects you.

Initial Commit

Terminal
$ git add .
$ git commit -m "Initial project setup"
โ–Œ

Why Structure Matters

Claude reads your project structure:

plaintext
Good:                          Bad:
my-project/                    stuff/
โ”œโ”€โ”€ src/                       โ”œโ”€โ”€ code.js
โ”‚   โ”œโ”€โ”€ components/            โ”œโ”€โ”€ other-code.js
โ”‚   โ””โ”€โ”€ utils/                 โ”œโ”€โ”€ test.js
โ”œโ”€โ”€ tests/                     โ””โ”€โ”€ random-file.txt
โ”œโ”€โ”€ docs/
โ”œโ”€โ”€ CLAUDE.md
โ””โ”€โ”€ README.md

Aussie Note

Think of it like organizing your shed. Claude can find things faster when everything has its place! ๐Ÿ”ง

Common Project Structures

Web App

plaintext
my-app/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ””โ”€โ”€ styles/
โ”œโ”€โ”€ public/
โ”œโ”€โ”€ tests/
โ”œโ”€โ”€ CLAUDE.md
โ””โ”€โ”€ package.json

API/Backend

plaintext
my-api/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ””โ”€โ”€ middleware/
โ”œโ”€โ”€ tests/
โ”œโ”€โ”€ CLAUDE.md
โ””โ”€โ”€ package.json

Key Takeaways

  • Always initialize git first
  • Create CLAUDE.md for AI context
  • Use clear folder names
  • Add .gitignore immediately
  • Make an initial commit before coding