Career readiness
Turn a course project into a portfolio project.
A working project and a portfolio-ready project are not the same thing. This is the gap most learners never close — here's exactly how to close it.
GitHub repository standards
- A focused, descriptive repository name (not "project1")
- A meaningful commit history — small, well-labeled commits, not one giant commit
- A README with a live demo link, screenshots, setup steps, and technologies used
- No secrets, API keys, or node_modules committed
- A LICENSE file (MIT is a safe default for portfolio projects)
- The app actually deployed and reachable at a public URL
README structure that actually gets read
Name and one-sentence pitch → screenshot → live demo link → features → technologies → setup steps → a challenge you solved → lessons learned → license. Put the demo link near the top — reviewers rarely scroll far.
Commit history as a signal
A history of small, clearly labeled commits (feat:, fix:, docs:) reads as someone who works in a professional, reviewable way — the same workflow used throughout this course.
Screenshots and a live demo
A reviewer often decides whether to read further within seconds. A real screenshot and a working deployed link do more than paragraphs of description.
Challenges solved & lessons learned
Naming one real bug you hunted down, or one tradeoff you made and why, demonstrates judgment — the thing a finished feature alone can't show.
Reusable README template
# Project Name
One sentence describing what this project does and who it's for.
**Live demo:** https://your-deployment-url.vercel.app
## Features
- Feature one
- Feature two
- Feature three
## Technologies
- JavaScript (ES6+)
- (Add your actual stack: HTML/CSS, a framework, an API, etc.)
## Getting started
```bash
git clone https://github.com/your-username/your-repo.git
cd your-repo
npm install
npm run dev
```
## Challenges solved
Briefly describe one or two real problems you solved and how — this is
what interviewers and hiring managers actually read.
## Lessons learned
What you would do differently next time, or what you learned building it.
## License
MIT