What I cannot create, I do not understand β Richard Feynman.
Use Vibe-Coding to make βfrom-scratchβ building faster, smoother, and more fun.
This repo preserves the spirit of build-your-own-x, and upgrades the workflow for the LLM era:
- Vibe-Coding = short iterative loops + lightweight prompt recipes + runnable scaffolds + tiny wins.
- LLMs in the loop: prompt recipes, debug diaries, and auto-checks live alongside the code.
A pragmatic build style:
- Micro loops (15β25 min): set one tiny goal β build β run β jot what felt off (the βvibeβ).
- Prompt recipes: reusable 10β15 line prompts for planning, refactors, tests, and perf hints.
- Scaffolds over specs: start from minimal templates; ship something runnable ASAP.
- Reality checks: each step ends with an auto-runnable check (script/notebook/test).
- Build diary: keep a
vibes.mdper project β 1β3 bullets/loop: intent β friction β next.
TL;DR: Less ceremony, more momentum. Learn a bit, run a bit, close the loop.
- Claude Code
- Gemini Cli
- Cline
- Codex
- Cursor
Weβre actively collecting: Community showcases β repos/blog posts that used Vibe-Coding to complete a BYO-X project.
Open a PR or issue with:
- Link(s): repo and/or blog post
- Vibe artifacts:
recipes/*.md(prompts),checks/*(auto-checks),scaffolds/*(minimal runnable) - Build diary:
vibes.md(3 bullets: intent β friction β next) - Notes: compute used, dataset/source, license
Looking for real build diaries + prompts that wrap classic BYO-X topics.
- 3D Renderer β repo/blog + prompts + scaffold + check
- Augmented Reality β repo/blog + prompts + scaffold + check
- BitTorrent Client β repo/blog + prompts + scaffold + check
- Blockchain / Cryptocurrency β repo/blog + prompts + scaffold + check
- Bot (Discord/Slack/etc.) β repo/blog + prompts + scaffold + check
- Command-Line Tool β repo/blog + prompts + scaffold + check
- Database (mini-KV / Redis-like) β repo/blog + prompts + scaffold + check
- Docker / Container-from-scratch β repo/blog + prompts + scaffold + check
- Emulator / VM β repo/blog + prompts + scaffold + check
- Front-end Framework / React-from-scratch β repo/blog + prompts + scaffold + check
- Game (Tetris/Rogue/etc.) β repo/blog + prompts + scaffold + check
- Git internals (mini-git) β repo/blog + prompts + scaffold + check
- Network Stack β repo/blog + prompts + scaffold + check
- Operating System (toy kernel/bootloader) β repo/blog + prompts + scaffold + check
- Physics Engine β repo/blog + prompts + scaffold + check
- Programming Language / Compiler β repo/blog + prompts + scaffold + check
- Regex Engine β repo/blog + prompts + scaffold + check
- Search Engine β repo/blog + prompts + scaffold + check
- Shell β repo/blog + prompts + scaffold + check
- Template Engine β repo/blog + prompts + scaffold + check
- Text Editor β repo/blog + prompts + scaffold + check
- Visual Recognition System β repo/blog + prompts + scaffold + check
- Voxel Engine β repo/blog + prompts + scaffold + check
- Web Browser β repo/blog + prompts + scaffold + check
- Web Server / Framework β repo/blog + prompts + scaffold + check
- Pick a topic β open
blueprints/<topic>/README.md. - Copy the Prompt Recipes and follow the steps (each section stands alone).
- Run the auto-check via
checks/<topic>_smoke.*or a small notebook. - Log your loop in
vibes.mdso you can reproduce & share later.
- π― Tiny intent: define one win.
- βοΈ Plan w/ recipe: paste system prompt (plan/refactor/test).
- π οΈ Do the thing: code the minimum; prefer a scaffold.
- β
Auto-check: run
checks/*and capture the output. - π Log vibe: append 1β3 bullets to
vibes.md(intent β friction β next).
- Python: Mini-GPT: tokenizer β tiny Transformer β next-token sampling.
- JavaScript/React: Coding with ChatGPT-5 - App Development with AI | Full Tutorial - Vibe Coding (Video)
We love classic βfrom-scratchβ tutorials and Vibe-wrapped upgrades.
For each PR, please include:
- One minimal runnable example (script/notebook/app)
- line prompt recipe (planning/refactor/test/perf) in
recipes/ - An auto-check in
checks/(smoke test or small eval) - short bullets from your
vibes.md(intent β friction β next)
You can also βVibe-wrapβ any existing entry by adding a tail line under it:
Submissions welcome β open a PR or create an issue.
Help review pending submissions with comments and reactions.
This project is inspired by and extends the free, community-maintained repository Build Your Own X.
- Original repo: codecrafters-io/build-your-own-x
- Started by Daniel Stefanovic, now maintained by CodeCrafters, Inc.
- License: CC0 1.0 (rights waived to the extent possible under law)
Not affiliated with CodeCrafters; we simply β€οΈ their work and the community around it.