Pick your project type. Fill in the sections. Get a professional README.md in minutes — not hours.
Three steps. Five seconds.
Select from 8 types to get smart defaults and the right sections pre-loaded.
Edit sections, add badges, drag to reorder. Watch your README Score climb.
One click to copy markdown or download as README.md. Paste into your repo.
This will add a "MITLicense" badge and a license section to your README.
TypeScript-first [category] with static type inference
A lightweight, zero-dependency library that makes [problem] simple. Built with TypeScript, tree-shakeable, and fully tested.
Node.js >= 18
npm install my-library
# or
yarn add my-library
# or
pnpm add my-library
import { createSchema, validate } from 'my-library'
// Define a schema
const userSchema = createSchema({
name: string().min(1),
email: string().email(),
age: number().optional(),
})
// Validate data — fully typed result
const user = validate(userSchema, data)
console.log(user.name) // TypeScript knows this is a string
createSchema(definition)Creates a new validation schema.
| Parameter | Type | Description |
|---|---|---|
definition |
SchemaDefinition |
Required. Object describing the shape |
Returns: Schema<T> — a typed schema object
validate(schema, data)| Parameter | Type | Description |
|---|---|---|
schema |
Schema<T> |
Required. Schema to validate against |
data |
unknown |
Required. Input data |
Returns: T — the validated and typed data
Throws: ValidationError with detailed error messages
Contributions are welcome! Here’s how:
git checkout -b feature/amazing-feature)npm test)git commit -m 'feat: add amazing feature')git push origin feature/amazing-feature)Please follow Conventional Commits for commit messages.
Copyright 2026 Your Name
This project is licensed under the MIT License.
Every other tool uses the same sidebar-form-preview pattern. We built something better.
8 project types (library, CLI, web app, API, profile, internal, hackathon, monorepo) with smart defaults. Pick your type and get the right sections pre-loaded.
Each project type comes with a curated set of sections, smart placeholder content, and type-specific badge suggestions. A library gets install commands and API reference; a hackathon project gets a quick demo link and team credits.
A real-time score that gamifies completeness. Structure (40pts), Content (40pts), Polish (20pts). Get suggestions to improve as you go.
The score algorithm checks for title, installation, usage, badges, features, license, contributing guidelines, and more. Color-coded from red (0-30) through amber, blue, to green (81-100). Aim for 80+ for a professional README.
Browse 20+ shields.io badges by category. Build, coverage, version, license, downloads, language — pick and click. Auto-fills your owner/repo.
No more copy-pasting shield URLs from documentation. Select badges from a visual picker, see live previews, and add custom badges with any shields.io URL. All badge URLs auto-populate with your GitHub username and repo name.
24 section types organized into essential, recommended, and optional categories. Drag to reorder, collapse to declutter, delete what you don't need.
Each section has a type-specific editor: text fields, badge pickers, list builders, key-value tables, license selectors, and demo link inputs. The block-based approach lets you see your entire README structure at a glance.
Everything you need to know.
Yes, completely free with no signup, no account, and no limits. Generate as many READMEs as you want. Your content stays in your browser via local storage.
Smart defaults, visual badges, drag-and-drop sections. Build it in minutes.