🚀 Build Your Own X with Vibe Coding

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.

Table of Contents

• 🚀 Build Your Own X with Vibe Coding
  • Table of Contents
  • What is Vibe-Coding?
    • Tools
      • Tutorial
  • ❤️ Need Your Help !
    • How to submit
    • Community Vibe-Coding Showcases (repos/blogs)
  • How to Use
    • The Vibe Loop (cheat-sheet)
  • Tutorials
    • Build your own LLM (from scratch)
    • Build your own APP
    • Build your own Game
  • Contribute
  • Credits

What is Vibe-Coding?

A pragmatic build style:

1. Micro loops (15–25 min): set one tiny goal → build → run → jot what felt off (the “vibe”).
2. Prompt recipes: reusable 10–15 line prompts for planning, refactors, tests, and perf hints.
3. Scaffolds over specs: start from minimal templates; ship something runnable ASAP.
4. Reality checks: each step ends with an auto-runnable check (script/notebook/test).
5. Build diary: keep a vibes.md per project — 1–3 bullets/loop: intent → friction → next.

TL;DR: Less ceremony, more momentum. Learn a bit, run a bit, close the loop.

Tools

• Claude Code
• Gemini Cli
• Cline
• Codex
• Cursor

Tutorial

• Vibe coding in prod | Code w/ Claude

❤️ Need Your Help !

We’re actively collecting: Community showcases — repos/blog posts that used Vibe-Coding to complete a BYO-X project.

How to submit

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

---

Community Vibe-Coding Showcases (repos/blogs)

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

How to Use

1. Pick a topic → open blueprints/<topic>/README.md.
2. Copy the Prompt Recipes and follow the steps (each section stands alone).
3. Run the auto-check via checks/<topic>_smoke.* or a small notebook.
4. Log your loop in vibes.md so you can reproduce & share later.

The Vibe Loop (cheat-sheet)

• 🎯 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).

Tutorials

Build your own LLM (from scratch)

• Python: Mini-GPT: tokenizer → tiny Transformer → next-token sampling.

Build your own APP

• JavaScript/React: Coding with ChatGPT-5 - App Development with AI | Full Tutorial - Vibe Coding (Video)

Build your own Game

• JavaScript: Making An Actually Fun Game (NO Coding experience) (Video)

Contribute

We love classic “from-scratch” tutorials and Vibe-wrapped upgrades.

For each PR, please include:

1. One minimal runnable example (script/notebook/app)
2. line prompt recipe (planning/refactor/test/perf) in recipes/
3. An auto-check in checks/ (smoke test or small eval)
4. 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.

Credits

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.