Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Builder Protocol product screenshot

Open Builder Protocol

Open recipes for real projects, demos, and evidence.

GitHub Actions License: MIT Contributions welcome

Quick Start · Recipe Library · Contributing · Product Plan

What It Is

Open Builder Protocol is a GitHub Pages-friendly product that turns real work systems into buildable project recipes. It helps students and young builders create a demo in 48 hours to 7 days, collect evidence, publish notes, and contribute their versions back.

The product is designed for people who are often told to "build real projects" but are rarely given a concrete structure for what to build, how to validate it, and how to present it.

Do not just tell people to become builders. Give them recipes they can build from.

Why It Matters

Most portfolio advice stops at motivation. Open Builder Protocol starts at execution:

  • Pick a real work system.
  • Build the smallest useful version.
  • Collect user evidence.
  • Turn the work into a demo.
  • Contribute the recipe or your version back.

The long-term ambition is to become an open learning infrastructure for non-technical builders: content planners, campus operators, student leaders, HR and culture interns, and anyone who needs to prove judgment through shipped work.

Product Highlights

Capability What it does
Recipe Library Browse 12 buildable project recipes across culture content, AI workflow, campus systems, career assets, and builder systems.
Builder Board Select a recipe, follow 48h tasks, review a 7-day plan, and track progress locally.
Demo Generator Generate a Markdown submission with problem, deliverables, evidence, and next-version prompts.
Contribution Kit Use templates and issue forms to add recipes, submit demos, or improve validation methods.
GitHub Pages Ready Static HTML, CSS, and JavaScript. No build step, no backend, no package install.

Screenshots

Desktop

Open Builder Protocol desktop

Mobile

Open Builder Protocol mobile

Quick Start

This is a static project. No build step is required.

python3 -m http.server 8080

Then open:

http://localhost:8080

You can also open index.html directly, because the recipe data is loaded as a plain JavaScript file instead of a JSON fetch.

Deploy To GitHub Pages

This repository includes a GitHub Pages workflow at .github/workflows/pages.yml.

To publish:

  1. Push the repository to GitHub.
  2. Go to Settings -> Pages.
  3. Under Build and deployment, choose GitHub Actions.
  4. Push to the main branch.
  5. The workflow will upload the repository root as a static site.

The app entry point is index.html.

Recipe Library

The first public version includes 12 recipes:

Recipe Track Duration
Build your own employee story column Culture Content 48h
Build your own 48h onboarding kit People Growth 48h
Build your own AI workflow library AI Workflow 7d
Build your own campus signal board Campus System 7d
Build your own culture event content engine Culture Content 7d
Build your own feedback machine Builder System 48h
Build your own internship portfolio Career Asset 7d
Build your own student club operating system Campus System 7d
Build your own interview question bank Career Asset 48h
Build your own content experiment board Content System 7d
Build your own team knowledge base People Growth 7d
Build your own decision log Builder System 48h

Each recipe includes:

  • Target user
  • Real problem
  • System to build
  • 48h tasks
  • 7-day plan
  • Deliverables
  • Validation metrics
  • Xiaohongshu content angles
  • Evidence to attach

Repository Structure

.
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── demo-submission.md
│   │   └── new-recipe.md
│   └── workflows/
│       └── pages.yml
├── artifacts/
│   ├── open-builder-protocol-desktop.png
│   └── open-builder-protocol-mobile.png
├── data/
│   └── recipes.js
├── docs/
│   └── open-builder-protocol-product-plan.md
├── templates/
│   ├── demo-submission.md
│   └── recipe.md
├── app.js
├── index.html
├── styles.css
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Design Principles

  • Every recipe must be buildable in 48 hours.
  • Every recipe must produce concrete deliverables.
  • Every recipe must include evidence and validation.
  • Every recipe must help users explain judgment, not just output.
  • Every recipe should be reusable by students, teams, or organizations.

Contributing

You can contribute:

  • A new recipe
  • A real demo built from a recipe
  • A better validation method
  • A Xiaohongshu title angle
  • A translation
  • A design or accessibility improvement

Start with:

Roadmap

  • Add community demo gallery
  • Add exportable recipe pages
  • Add multilingual recipe data
  • Add monthly Builder Report
  • Add public contributor showcase
  • Add analytics-free usage telemetry option

License

MIT

About

Open recipes for real projects, demos, and evidence.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages