Start at step 01 → · All free repos · Watch the lessons
Learn. Build. Ship. From zero to your first project on the internet: how the web works, Git, the terminal and databases, one small step at a time.
This repository holds the finished code and notes for every step of the free Developer foundations path. Each step folder shows what your own work should look like at the end of that lesson, so you can compare, or start again from the step before.
Follow the lessons in order. Each one tells you which folder to work in and ends with a commit.
| Step | Folder | Lesson | You work in |
|---|---|---|---|
| 01 | step-01-how-the-web-works | How the web works | ~/ewoi-learning/notes |
| 02 | step-02-your-first-commit | Your first commit, explained | ~/ewoi-learning/first-app |
| 03 | step-03-branches-without-fear | Branches without fear | ~/ewoi-learning/first-app |
| 04 | step-04-linux-files-and-permissions | Linux files and permissions | ~/ewoi-learning/notes/linux |
| 05 | step-05-find-the-permission-bug | Find the permission bug (exercise) | ~/ewoi-learning/linux-exercise |
| 06 | step-06-sql-select-and-where | SQL: SELECT and WHERE | ~/ewoi-learning/sql |
| 07 | step-07-write-the-query | Write the query (exercise) | ~/ewoi-learning/sql |
The path ends with a project you publish yourself: Your portfolio website, live, with its template in portfolio-website.
- A laptop or desktop and a stable internet connection
- Operating system: Windows 10 or 11, macOS or Linux
- Prerequisites: none. Start at step 01.
- Tools (search for each on its official site, download only from the official site, and check the address before installing):
- A web browser (Chrome, Firefox, Edge or Safari): steps 01 onwards
- Git 2.28 or newer: search for "Git official download". On Windows it includes Git Bash, the terminal for steps 02 and 03
- A code editor, such as Visual Studio Code: search for "VS Code official download"
- On Windows, WSL with Ubuntu for steps 04 to 07: in PowerShell as administrator, run
wsl --install - SQLite 3.33 or newer for steps 06 and 07: built into macOS; on Ubuntu or WSL,
sudo apt install sqlite3
-
Set your identity, with the email you use on GitHub:
git config --global user.name "Your Name" git config --global user.email "you@example.com" git config --global init.defaultBranch mainOn Windows, WSL is a separate system: run these again inside Ubuntu before step 04.
-
To push your own copy to GitHub, set up an SSH key (
ssh-keygen -t ed25519 -C "you@example.com", add the.pubkey on GitHub under Settings, SSH and GPG keys, test withssh -T git@github.com) or a fine-grained personal access token used as your password over HTTPS. Keep the private key and the token to yourself. -
Create your own repository on GitHub by hand, then clone it by SSH (
git@github.com:USER/REPO.git) or HTTPS (https://github.com/USER/REPO.git). -
This repository's
.gitignorealready keeps.env,*.db,node_modules/andvendor/out of Git. Keep secrets in.envon your computer and never commit them.
Download it once:
git clone https://github.com/ewoibuilds/developer-foundations.git
cd developer-foundations
Then, for each step, either:
- Compare: do the lesson in your own
~/ewoi-learningfolder first, then compare your files with the step folder (diff -ron macOS and Linux shows every difference), or - Start from the step before: copy the previous step's files into your workspace and carry on from there. Each step README shows the exact commands.
The step folders are not Git repositories of their own: you make your own repositories in ~/ewoi-learning, as the lessons show. Git does not keep empty folders or read-only files, so the step 05 starter has a setup.sh that recreates the broken state.
- Steps 02 to 07:
git statusin your workspace folder saysnothing to commit, working tree clean, andgit log --onelineshows the commit messages listed in the step README. - Step 04:
./hello.shprintsHello from my script. - Step 05:
./backup.shadds aBackup ran atline tologs/backup.logevery time. - Steps 06 and 07:
sh create-database.shprints the row count, and your queries print the expected output in the step README.
developer-foundations/
├── step-01-how-the-web-works/ notes/web.md, your Network tab notes
├── step-02-your-first-commit/ first-app/ after five commits
├── step-03-branches-without-fear/ first-app/ after two branches and two resolved conflicts
├── step-04-linux-files-and-permissions/ notes/linux/ with two runnable scripts
├── step-05-find-the-permission-bug/ starter/ (broken) and solution/ (fixed)
├── step-06-sql-select-and-where/ sql/ with lessons.sql and practice.sql
└── step-07-write-the-query/ starter/ (the shop and six questions) and solution/
| Problem | Fix |
|---|---|
git: command not found or "not recognised" |
Install Git from the official site, then open a new terminal |
Please tell me who you are |
Run the git config --global lines in Git setup (again inside WSL on Windows) |
fatal: not a git repository |
cd into your workspace folder for the step, or run git init where the lesson says |
| PowerShell writes strange characters into files | Use Git Bash for steps 02 and 03, and Ubuntu (WSL) for steps 04 to 07 |
Permission denied when running a .sh file |
Read it with ls -l; add x for the owner with chmod u+x file, or run helpers with sh file |
sqlite3: command not found |
sudo apt update, then sudo apt install sqlite3 (Ubuntu or WSL) |
Query results all on lines with | and no headings |
Add -header -column, or type .headers on and .mode column at the sqlite> prompt |
table lessons already exists |
The table is there already. Use sh create-database.sh to start clean |
Learn the step first, then ask for help with something you can check. A good prompt:
I am a complete beginner on step 05 of Developer foundations (Linux permissions, Ubuntu on WSL). I ran
./backup.shand saw: [paste the message]. Here isls -l backup.sh logs/backup.log: [paste it]. Do not give me the command. Explain in simple words what each permission string means and which letter is missing.
Check every answer against the lesson and the official docs (git-scm.com, sqlite.org, developer.mozilla.org), and never paste passwords, keys or tokens into a chat.
MIT. See LICENSE.
- Star this repo so you can find it again, and so more learners discover it.
- Follow Ewoi Builds on GitHub to get the next steps and projects as they land.
- Build it, then show it: push your version to your own GitHub and share the link with us.
- Stuck? Open an issue with the "I am stuck" form. Say which step, what you ran and what you saw.
- Lessons stay free. If this helped, you can say thanks with Buy me a soda or Buy me a coffee.
Follow along: GitHub, TikTok, Instagram, Facebook, YouTube.
Learn. Build. Ship.
