Start at step 01 → · All free repos · Watch the lessons
Learn. Build. Ship. The sample code for the Ewoi Builds "Practical software development" path: build pages, APIs and M-Pesa payments with Laravel 13, one working step at a time.
Do the lessons in this order. Each step folder holds the files that lesson creates or changes, so you can compare your work or catch up.
Then build the path's projects: task-tracker-laravel and mpesa-checkout-api.
- A laptop or desktop and a stable internet connection
- Operating system: Windows 10 or 11, macOS or Linux
- Prerequisites: the Developer foundations path, or the same skills (terminal, Git, how the web works)
- Tools (search for each on its official site; download only from the official site and check the address):
- PHP 8.3 or newer: search for "Laravel installation php.new" (Laravel's official installer sets up PHP and Composer together)
- Composer 2: search for "Composer official download"
- Git: search for "Git official download"
- A code editor, for example Visual Studio Code: search for "Visual Studio Code official download"
- For step 05 only: a free Safaricom Daraja developer account (search for "Safaricom Daraja developer portal")
These steps use Laravel 13. Check yours with php artisan --version inside your app.
- Set your identity:
git config --global user.name "Your Name"andgit config --global user.email "you@example.com"(the email you use on GitHub). - To push your own copy, 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 (no README if you will push an existing folder), then connect your app folder:
git remote add origin git@github.com:USER/REPO.git,git branch -M main,git push -u origin main. - Laravel's own
.gitignorealready excludes.envandvendor/. Commit.env.examplewith placeholder values; keep.envon your machine.
This repo does not contain a whole Laravel app. Each step folder holds only the files the lesson creates or changes, at their real Laravel paths (routes/web.php, app/Models/..., tests/Feature/...). Create your app as the lesson says (~/ewoi-learning/laravel-app), then either:
- Compare: open a file here next to yours and look for differences, or
- Catch up: copy a step's files into your app (keeping the same paths) to start the next lesson from a working state.
git clone https://github.com/ewoibuilds/practical-software-development.git
cd practical-software-developmentOn macOS and Linux you can copy a whole step into your app in one go, for example:
cp -R step-01-your-first-laravel-route/routes step-01-your-first-laravel-route/resources step-01-your-first-laravel-route/tests ~/ewoi-learning/laravel-app/On Windows, copy the folders in File Explorer into the same places.
Every step has a feature test in tests/Feature/. Copy it into your app and run, from your app folder:
php artisan testAll tests should pass. A failing test names the promise that is broken, for example "the about route does not accept GET".
step-01-your-first-laravel-route/ routes, the about view and a test
step-02-fix-the-broken-route/ starter/ (broken on purpose) and solution/
step-03-build-a-rest-api/ the lessons API: model, migration, api routes, test
step-04-hash-passwords-properly/ README: the code lives in secure-web-development
step-05-mpesa-stk-push/ M-Pesa service, payments, callback, job, tests with Http::fake
| Problem | Fix |
|---|---|
php artisan test says a class is not found |
Check you copied the file to the same path as here, and that the step before is in place too |
Cannot use ... as Request because the name is already in use |
A use line appears twice at the top of routes/api.php; keep one |
no such table in the browser |
Run php artisan migrate |
| A migration name differs from yours | Normal: yours starts with the date you created it. Compare the contents, not the name |
Step 05: The M-Pesa setting ... is empty |
Add the MPESA_ values to your .env, then run php artisan config:clear |
Learn the concept in the lesson first, then ask for small steps. A good prompt:
I am learning Laravel 13. Here is my routes/api.php from the Build a REST API lesson: [paste it]. Compare it with the lesson's goals (validation, 201 on create, 404 for a missing lesson) and give me hints, not a rewrite.
Check every answer against the lesson and the official docs (laravel.com/docs), and never paste keys or your .env into a prompt.
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.
