Early-access beta โ€” help shape the onboarding flow

Your GitHub repo is
already a course

Write lessons in Markdown. Ship quizzes in YAML. Deploy with git push. Start free, self-host if you want, and only turn on paid access when it actually fits your workflow.

Paste owner/repo, a full GitHub URL, or even a /tree/main/docs/course link โ€” we'll normalize it for you.

Useful for monorepos, docs folders, or a course stored in a subdirectory.

๐Ÿ”’ Read-only GitHub previewโ†ฉ๏ธ We never push to your repo๐Ÿ–ฅ๏ธ Export + self-host supported
Try:
terminal โ€” @teachrepo/cli
# Import your GitHub repo (web dashboard)
โ†’ teachrepo.com/dashboard โ†’ Import from GitHub
# Or use the CLI today (see docs/cli)
$ npm install -g @teachrepo/cli # available now
$ teachrepo import --repo=https://github.com/you/your-course
# Push to update
$ git push origin main
โœ“ Course site published at teachrepo.com/courses/your-course
Prefer to jump straight in? Create a free account โ†’

Proof first ยท No credit card ยท Free forever ยท MIT licensed ยท Optional paid access

Free to self-host ยท MIT licensed ยท No lock-in ยท hello@teachrepo.com

๐Ÿ“ฆStarter kit

Get the starter kit in your inbox

Weโ€™ll send the course.yml example, lesson frontmatter, quiz YAML, and the fastest proof path so you can test TeachRepo without committing to a signup first.

Best for creators who want proof first: sample repo, starter files, and self-host guidance before committing to a paid plan.
No credit cardRead-only preview firstSelf-host path includedHuman help if you get stuck
Pick the lowest-risk first step

Low signups usually mean the first move is still too fuzzy.

So this is the honest split: repo-first, notes-first, or self-host-first. Choose the path that already matches how your material actually exists today.

Repo already exists

Bring one repo and judge the workflow quickly.

Best if your lessons already live on GitHub and you want the fastest proof path into a real import.

Only have Markdown notes

Start from a folder, not a polished repo.

Use the notes-first starter kit if your material lives in workshop notes, docs drafts, or a local Markdown folder.

Self-host comes first

Keep MIT + self-host real from day one.

For skeptical operators who only want hosted later if it clearly saves time and earns the monthly cost.

Trust guardrails

The fastest way to lose technical creators is to make them guess.

These are the promises TeachRepo puts in front of skeptical repo-first users before asking them to sign up or pay.

Read-only preview first

You can generate a repo outline before signup. TeachRepo does not push to your GitHub repo during preview.

Export + self-host stay real

MIT-licensed core, transparent file format, and a clear self-host path if you do not want platform lock-in.

Async is welcome

If calls or recordings are annoying, you can stay async over email and still get help or share feedback.

Human help on the first import

Concierge onboarding is available for the first repo so creators do not get stuck reverse-engineering the format.

๐ŸŽฌWorkflow proof

Show the flow before asking for trust.

The sharpest feedback so far was predictable: engineers want a believable proof path, not just pricing and feature claims. So this beta now makes the sample flow, the starter kit, and the self-host route visible before signup.

Read-only proof first

Generate an outline from a public repo before you sign up. No repo writes, no GitHub mutation, no lock-in.

Starter kit instead of guesswork

Copy a known-good course.yml, lesson frontmatter block, quiz YAML, and deploy checklist in one place.

Hosted only if it saves time

Self-host stays real. Hosted has to earn its keep by shortening setup and helping you ship faster.

teachrepo demo โ€” repo โ†’ outline โ†’ publish
TeachRepo demo flow showing repo import and course publishing
This is the quickest proof path if you're skeptical: sample repo first, starter kit second, account creation third.
Why this exists

For engineers, the alternative is usually glue code.

Zero signups and zero revenue usually mean one thing: the value is still fuzzy. TeachRepo only deserves to exist if it beats the obvious alternatives for repo-first creators who want proof, not lock-in.

Git-native course publishing

TeachRepo

  • โ€ขMarkdown + YAML stay source-of-truth
  • โ€ขPayments, previews, and versioned updates in one stack
  • โ€ขSelf-hostable if managed hosting is not worth it
Docusaurus / MkDocs / GitBook

Docs stack

  • โ€ขGreat for docs, but payments and gated lessons are bolt-ons
  • โ€ขYou still have to stitch together auth, checkout, and access control
  • โ€ขBest when free documentation is the whole product
SSG + Gumroad + custom glue

DIY stack

  • โ€ขMaximum control, but you own every integration and edge case
  • โ€ขUseful if you actively want to build course infrastructure yourself
  • โ€ขMost creators only want this if hosted tools break trust or flexibility
Fast comparison

Use hosted only if it saves more time than the DIY or docs-only path.

QuestionTeachRepoDocs stackDIY stack
Git-native authoringYes โ€” repo stays canonicalUsually yesYes
Built-in paid accessYes โ€” optionalNoNot by default
Versioned course updatesYesDocs onlyOnly if you wire it yourself
Self-host pathYes โ€” MIT coreYesYes
Why pay hosted?To skip setup + opsNo hosted course layerYou pay in time instead
Honest rule: if free docs or self-hosted infrastructure already solve your workflow, keep them. Hosted Creator should win on speed, not pressure.
๐Ÿ†“ Free plan includes:
โœ“ 3 courses / 10 lessons eachโœ“ Stripe checkoutโœ“ Git-native versioningโœ“ Self-hostable (0% fee)โœ“ 3 AI quiz generations / month
See full plan โ†’
Who this is actually for

Zero signups usually means the audience still has to squint.

Discovery feedback kept repeating the same pattern: TeachRepo works best for technical creators who already publish from repos and want a low-risk path to course structure, previews, and optional payments.

Best fit
  • โœ“You already teach from GitHub, Markdown docs, workshop repos, or lab materials.
  • โœ“You want one free preview lesson before asking anyone to pay.
  • โœ“You want self-hosting to stay possible, but would pay later if managed launch speed is obviously better.
Probably not for you
  • โ€”You only want a marketing site or docs site and already have that solved.
  • โ€”You never plan to teach, package lessons, or charge for access.
  • โ€”You reject any paid layer on principle, even when it saves real setup work.

โ€œTurning GitHub repos into courses feels genuinely useful, especially for developers.โ€

Rayanul Kader Chowdhury

โ€œa single strongest proof, e.g., starter repo would be the most convincing way to prove the 15-minute setup promise.โ€

Rudra Sarker

โ€œHonest answer is no, I wouldn't have any use for it.โ€

Robin Moisson
Need the honest next step?

Pick the path that matches your workflow

Most repo-first creators do not want the same thing. Answer three quick questions and weโ€™ll point you to the lowest-friction next move.

How do you feel about managing infra?
How soon do you want a course live?
Would you pay if TeachRepo saves real setup time?
Recommended path

Use concierge beta before deciding

You want proof and a human sanity check before choosing self-hosted or paid.

  • โ€ขBring one repo or docs folder and weโ€™ll help you judge fit quickly.
  • โ€ขBest when you are curious but still skeptical about the first import.
  • โ€ขGood fallback if calls are annoying โ€” async email works too.
Book onboarding help โ†’

Self-host stays available either way. Hosted only wins if it saves enough time to matter.

Validated learning

What real repo-first users pushed back on

We cleared the 10-reply outreach gate before touching the product. These were the sharpest objections, so they now shape the product copy and onboarding path.

"A single strongest proof, e.g., starter repo, would be the most convincing way to prove the 15-minute setup promise."

RS
Rudra Sarker
learner / indie engineer

"No ... Free self hosting ... make an onboarding video."

DM
David Miserak
infrastructure engineer

"Not interested in putting anything behind a pay-walled product."

SW
Sascha Willems
maintainer / educator
What changed because of this
Starter-template-first onboarding

The sample import path and template are now front-and-center so people can test the workflow before committing to a signup.

Self-host is a real first-class path

We now say the quiet part out loud: many engineers want MIT + self-host first, and hosted only if it genuinely saves time.

Paid access is optional, not the identity

TeachRepo now leads with course publishing and proof. Monetization stays available, but it is no longer the first thing maintainers see.

Best next step if you're skeptical

Don't buy first. Import a sample repo, clone the template, or book a walkthrough. If the workflow feels real, then decide whether self-host or hosted is worth it.

GitRepo-first workflow
MITSelf-hostable core
QuizYAML-powered checks
BetaConcierge onboarding available
How it works

From repo to course in 15 minutes

01

Structure your repo

Add course.yml + a lessons/ folder to any GitHub repo. Copy from our template to skip setup.

02

Paste the GitHub URL

Drop the URL into the import form. We fetch lessons, parse YAML, and import everything automatically.

03

Set your price

price_cents: 0 for free, or any amount for paid. Stripe handles checkout, receipts, and refunds.

04

Publish and share

Hit Publish. Your course is live with a shareable link, SEO metadata, and a buy button.

Features

Everything a technical creator needs

๐Ÿ“

Markdown-first

Write lessons in plain Markdown. Frontmatter sets order, paywall, and quiz links โ€” no CMS needed.

๐Ÿ”’

Zero-config paywall

Set price_cents in course.yml. Stripe Checkout handles the rest โ€” access is enforced server-side.

๐Ÿงช

AI quiz generation

One click to generate MCQs from your lesson content. Edit, reorder, then save directly to the course.

๐Ÿ”€

Git-native versioning

Every import creates a version snapshot. Roll back or publish a new version with a single push.

๐Ÿ“Š

Creator analytics

See your full funnel: signups โ†’ imports โ†’ published โ†’ checkouts. Know exactly where you lose people.

๐Ÿ–ฅ๏ธ

Self-hostable, 0% fee

MIT-licensed core. Deploy on your own Vercel + Supabase in 10 minutes. Keep 100% of revenue.

Why pay at all?

Hosted Creator needs a better reason than convenience theater.

Revenue is still zero, so the paid offer has to become more legible. The honest pitch: hosted is for creators who want the repo-native workflow without babysitting the surrounding infrastructure.

01

Use Hosted Creator when publishing speed matters more than infra ownership.

02

Stay self-hosted if the MIT core already covers your workflow and you do not need managed checkout + analytics.

03

Use concierge if you are still deciding and want a human sanity check before you pay.

Decision point
Hosted Creator
Self-hosted core
Managed launch speed
Import, publish, checkout, and analytics in one place
You wire hosting, auth, Stripe, and updates yourself
Ongoing maintenance
TeachRepo handles the platform plumbing
You own deploys, billing edge cases, and auth drift
Reason to pay
Only worthwhile if it saves obvious time every launch
Best if you want full control and do not mind the setup work
Choose the right path

Not everyone should buy the hosted plan

Our outreach kept saying the same thing: self-host has to stay real, and hosted only wins if it clearly saves time. So here's the honest version.

Best for maintainers
Self-hosted core
$0
  • โ€ขYou want full control, MIT licensing, and no platform dependency.
  • โ€ขYou are comfortable with Vercel + Supabase or already have infra.
  • โ€ขYou care more about publishing than managed convenience.
Best for speed
Hosted Creator
$19/mo
  • โ€ขYou would pay to skip setup, ops, and maintenance work.
  • โ€ขYou want analytics, hosted checkout, and a faster path to launch.
  • โ€ขYou only upgrade if the time savings feel obvious.
Best for uncertainty
Concierge beta
$0
  • โ€ขYou are curious but not convinced the workflow will fit your repo.
  • โ€ขYou want a human to sanity-check course.yml, lessons, and pricing.
  • โ€ขYou would rather talk before you decide whether to self-host or pay.
Objections, answered

The questions that usually block signup.

The fastest way to lose a skeptical engineer is to dodge the hard questions. These are the ones that kept coming up in discovery, so we answer them directly.

Do I have to buy anything before I know this works?

No. The intended path is proof first: preview a sample repo, inspect the starter kit, and only create an account when the workflow feels believable.

What if I only want the self-hosted path?

That is a legitimate outcome. TeachRepo keeps the MIT + self-host route visible because many technical creators prefer control first and hosted only if it clearly saves time.

What if my content lives in a docs folder or monorepo?

That is why the preview accepts a path inside the repo. You can point TeachRepo at a subdirectory instead of reshaping the whole codebase upfront.

Who should not pay for Hosted Creator?

If you enjoy maintaining the stack yourself, only publish free docs, or do not need managed auth, checkout, and analytics, stay self-hosted and keep your $29.

What is the fastest credible first run?

Use the sample repo or starter kit, publish one free preview lesson, then share the live URL with a few people before touching marketplace or affiliate features.

Best low-risk next move

If you are still unsure, do the smallest credible thing: preview a repo, inspect the starter kit, or book a walkthrough. The product should earn the signup.

๐ŸงญWhat we're validating right now

Tell us if this should exist

We're talking to engineers and repo owners about one thing: can a repo-to-course flow feel fast, trustworthy, and worth paying for?

โ€œWould you actually try a repo-to-course flow on a real codebase or docs folder?โ€

01
Question 1
Workflow fit

โ€œIs onboarding under 15 minutes believable, or do you need a starter repo and concierge help first?โ€

02
Question 2
Time to value

โ€œWould you pay for a hosted version, or is self-hosted-only the right answer for this category?โ€

03
Question 3
Willingness to pay
โšกOpen Source

Free to Use. Free to Fork.

The TeachRepo core is MIT-licensed and self-hostable. Deploy to your own Vercel, keep 100% of revenue.

@teachrepo/cli โ€” quick install
npm install -g @teachrepo/cli
# Scaffold a new course
teachrepo new "Advanced Git for Engineers"
# Import from GitHub
teachrepo import --repo=https://github.com/you/your-course
# Validate course.yml
teachrepo validate --verbose
๐Ÿงช Concierge onboarding

We'll help you get the first repo live

Right now, getting a real creator through signup โ†’ import matters more than pushing referral mechanics. If you have a repo, workshop, or docs folder, we'll help you import it, fix frontmatter issues, and publish the first lesson.

15 min
live setup walkthrough
$19
hosted plan starting point
0%
pressure to upgrade before value

Ship your course this week.

If you can write Markdown, you can build a course. Free to start โ€” no credit card, no lock-in.