explaingit

anduin2017/howtocook

🔥 Hot100,171JavaScriptAudience · generalComplexity · 1/5ActiveLicenseSetup · easy

TLDR

A community-built collection of Chinese home-cooking recipes written in a clear, structured style for programmers who want reproducible, consistent instructions instead of vague blog posts.

Mindmap

mindmap
  root((repo))
    What it does
      Chinese recipes
      Structured format
      Programmer-friendly
    Organization
      Difficulty ratings
      Category sections
      Markdown files
    Kitchen guides
      Techniques
      Equipment tips
      Food safety
    How to use
      Read on GitHub
      Docker web service
      Download PDF
    Contributing
      Pull requests
      Recipe templates

Things people build with this

USE CASE 1

Look up a Chinese dish with clear, step-by-step instructions instead of searching inconsistent recipe blogs.

USE CASE 2

Learn cooking techniques like stir-frying, steaming, and pickling with structured explanations.

USE CASE 3

Host a local web version of the recipes using Docker for offline access while cooking.

USE CASE 4

Contribute your own tested recipes to help other programmers cook at home.

Tech stack

JavaScriptMarkdownDockerStatic site generator

Getting it running

Difficulty · easy Time to first run · 5min
Public domain. Use however you want, no attribution required.

In plain English

HowToCook (programmer's guide about how to cook at home) is a community-built collection of Chinese recipes written in a precise, structured style aimed at programmers cooking for themselves at home. The description and README make clear it is a Simplified Chinese cookbook. The author explains they often searched online for recipes but found the writing inconsistent and full of unclear ingredient names; as a programmer used to formal-language descriptions, they wanted clearer descriptions, so they started this project to gather and standardize how common dishes are made. How it is organized: the README links a difficulty index from 1 to 5 stars, plus category sections such as vegetable dishes and meat dishes. Each dish has its own markdown file under a dishes directory, written from a template the project provides. There are also "kitchen environment" guides under a tips directory covering kitchen preparation, choosing what to eat now, food pairings and taboos, pressure cooker, air fryer, removing fishy odors, food safety, microwave, and primers on techniques like boiling, stir-frying and pan-frying, cold mixing, pickling, steaming, and stewing. You can read recipes on GitHub, build a local web service from the README's Docker image, or download a generated PDF version. Contributors add or fix recipes by submitting pull requests. You would use this when you want a structured, reproducible, programmer-friendly reference for everyday Chinese home cooking rather than browsing inconsistent recipe blogs. The repository's primary listed language is JavaScript, since the recipes are tooled and published as a static site, and the full README is much longer than what was provided.

Copy-paste prompts

Prompt 1
Show me how to make [Chinese dish name] using the HowToCook recipe format with clear ingredient lists and step-by-step instructions.
Prompt 2
What kitchen techniques does HowToCook cover, and how can I use them to improve my home cooking?
Prompt 3
Help me set up the HowToCook Docker image locally so I can browse recipes offline while cooking.
Prompt 4
I want to contribute a Chinese recipe to HowToCook, what does the markdown template look like and what should I include?
Prompt 5
What are the difficulty ratings in HowToCook and which recipes would be good for a beginner cook?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.