Přejít na obsah
BBoilerplate
Registrovat se
Produkčně připravený boilerplate · Next.js 16 · Supabase · Vercel

Skutečnou víceuživatelskou aplikaci spustíte za dny, ne za měsíce

Boilerplate vám dá pracovní prostory s rolemi, přihlášení bez hesla i dvoufázové ověření, protokol aktivit, API a MCP server pro Claude a chytré formulářové prvky — otestované, zdokumentované a nasazené jedním příkazem. Vy stavíte jen to, čím se váš produkt liší.

ZačítCo je uvnitř

Přihlášení magickým odkazem — žádné heslo k zapamatování.

  • Testováno na čtyřech úrovních
  • Čeština a angličtina v základu
  • Na Vercelu zhruba za deset minut
python3 scripts/new-project.py

Celý výstup průvodce nastavením

  1. $ python3 scripts/new-project.py
  3. Tonda's Boilerplate · new project wizard
  4. Next.js · tRPC · Drizzle · Supabase · Vercel
  6. Tell me about the new project.
  7. ? Project name: Family Chronicle
  8. ? Folder / repository / Vercel project name [family-chronicle]:
  9. ? Database prefix (tables become <prefix>_user, …) [familychronicle]:
  10. ? Logo letter [F]:
  11. ? Describe the product in one sentence (for docs/PRODUCT.md) [To be described.]: A family's memories, recorded one evening at a time.
  12. ? Your email (becomes superadmin of the Platform workspace) [you@example.com]:
  13. ? Sender for emails (domain must be verified in Resend) [Family Chronicle <noreply@example.com>]:
  14. ? Copy API keys (Resend, AI providers) from the boilerplate's .env? [Y/n]:
  15. ? Will development use a separate Supabase project from production? [y/N]:
  17. Where it runs.
  18. ? GitHub owner for the private repo [tonyno]: you
  19. ? Vercel team
  20. › 1. (your personal account)
  21. choose 1-1 [1]:
  22. ? Supabase
  23. › 1. Create a NEW Supabase project (own users and logins — cleanest; free plan: 2 projects max)
  24. 2. Reuse boilerplate1 (eu-central-1) — separate tables via prefix, logins shared
  25. choose 1-2 [1]:
  26. ? Region
  27. › 1. Frankfurt (eu-central-1)
  28. 2. Ireland (eu-west-1)
  29. 3. N. Virginia (us-east-1)
  30. choose 1-3 [1]:
  31. ? Load the demo seed data into the PREVIEW database? [Y/n]:
  32. ? Load the demo seed data into PRODUCTION too? (fine for a new app, no real users yet) [Y/n]:
  34. Project Family Chronicle
  35. Folder /Users/you/code/family-chronicle
  36. Table prefix familychronicle_
  37. Superadmin you@example.com
  38. Email sender Family Chronicle <noreply@example.com>
  39. Auth per environment shared — one authenticator entry everywhere
  40. GitHub you/family-chronicle (private)
  41. Vercel family-chronicle · personal · fra1
  42. Supabase new project · eu-central-1
  43. Seed preview: yes, production: yes
  45. ? Go ahead? [Y/n]: y
  46. [1/14] Checking tools and logins
  47. ✓ git, node, psql, gh, vercel, supabase — all logged in; local Postgres reachable
  48. [2/14] Copying the boilerplate (with history)
  49. ✓ /Users/you/code/family-chronicle (remote 'boilerplate' → git@github.com:tonyno/boilerplate1.git)
  50. [3/14] Renaming the project
  51. ✓ prefix familychronicle_, brand "Family Chronicle" (F), superadmin you@example.com, region fra1, auth per env shared
  52. [4/14] Installing dependencies
  53. ✓ node_modules ready, git hooks installed
  54. [5/14] Checking migrations match the schema
  55. ✓ drizzle/ is in sync with src/server/db/schema/
  56. [6/14] Supabase project
  57. ✓ project qwertyuiopasdfghjklz (eu-central-1) — keys and pooler ready
  58. [7/14] Preview and E2E databases + migrations
  59. ✓ database preview created
  60. ✓ database e2e_test created
  61. ✓ production: migrations applied (familychronicle_* tables, row-level security on)
  62. ✓ preview: migrations applied (familychronicle_* tables, row-level security on)
  63. [8/14] Local databases and .env files
  64. ✓ local database familychronicle created
  65. ✓ local database familychronicle_test created
  66. ✓ .env, .env.test, .env.test.local written (chmod 600); local DBs migrated and seeded
  67. [9/14] Running the project's checks
  68. ✓ all green
  69. [10/14] Seeding the hosted databases
  70. ✓ preview: demo personas, workspaces and data loaded (docs/SEED_DATA.md)
  71. ✓ production: demo personas, workspaces and data loaded (docs/SEED_DATA.md)
  72. [11/14] Committing the new project
  73. ✓ initial commit on main
  74. [12/14] GitHub repository and CI secrets
  75. ✓ created github.com/you/family-chronicle (private)
  76. ✓ 5 E2E_* Actions secrets set
  77. [13/14] Vercel project, environment variables, Git connection
  78. ✓ 20 environment variables set (Production → postgres, Preview → preview database)
  79. ✓ repository connected — every push to main deploys production, every branch gets a preview
  80. [14/14] Pushing — first deployment
  81. ✓ pushed main → Vercel builds production now (≈3 min)
  82. ✓ live: https://family-chronicle.vercel.app (health: ok)
  86. Done! Family Chronicle is ready at /Users/you/code/family-chronicle
  87. cd /Users/you/code/family-chronicle && npm run dev → http://localhost:3000, log in with any email + code 1111
  88. GitHub https://github.com/you/family-chronicle
  89. Live https://family-chronicle.vercel.app
Skutečný průvodce nastavením, přehraný krok za krokem. Jeden příkaz založí repozitář, databáze, hosting i první nasazení. Zkrácený výstup s ukázkovými odpověďmi, převzatý ze scripts/new-project.py.

Postaveno na

  • Next.js 16
  • React 19
  • TypeScript
  • tRPC 11
  • Drizzle ORM
  • PostgreSQL
  • Supabase
  • Vercel
  • Tailwind CSS 4
  • shadcn/ui

Čísla, která za tím stojí

funkcí připravených od prvního dne
34
automatických testů
1 865
scénářů se snímky obrazovky
7
zdokumentovaných architektonických rozhodnutí
30+

Spočítáno v repozitáři pro toto vydání.

Skutečný produkt

Žádné makety. Tohle jsou skutečné obrazovky.

Zachyceno z běžící aplikace s ukázkovými daty — ve vašem jazyce i barevném režimu.

Stránka poznámek v pracovním prostoru Acme Studio se seznamem formátovaných poznámek
Formátované poznámky s nadpisy, seznamy, obrázky a @zmínkami — soukromé pro svého autora.

Vše, co seriózní aplikace potřebuje od prvního dne

Není to demo. Každá funkce níže má autorizaci na serveru, testy a dokumentaci; ukázkové funkce zůstávají ve forku jako referenční implementace.

Víceuživatelský základ

Pracovní prostory různých typů s rolemi a oprávněními definovanými v kódu, platforma pro provozovatele služby a stopa každé změny.

  • Pracovní prostory a pozvánky
  • Typy, role, oprávnění
  • Platformní prostor
  • Auditované jednání za uživatele
  • Protokol aktivit
  • Notifikace v aplikaci

Bezpečné už od základu

Žádná hesla, která by mohla uniknout, dvoufázové ověření tam, kde na něm záleží, databáze uzamčená řádek po řádku a přísná politika zabezpečení obsahu.

  • Přihlášení bez hesla
  • Dvoufázové ověření
  • Uzamčená databáze
  • Přísné bezpečnostní hlavičky
  • Sdílené limity požadavků

Připraveno na AI

Claude může s vaší aplikací pracovat přes API a MCP server a ukázkové funkce předvádějí, jak streamovat řeč i zpětnou vazbu od AI.

  • REST API a MCP server
  • Formátované poznámky
  • Živý přepis

Formulářová pole, která odvedou tu těžší práci

Ověřená pole pro údaje, které skutečné formuláře potřebují — včetně českých specifik, na která běžné sady zapomínají.

  • Telefon s vlajkou
  • Hlasové diktování
  • Přísnější e-mail
  • IČO s načtením z ARES
  • Číslo účtu na IBAN
  • Našeptávání adres
  • Částky a PSČ

Pro svět a pod kontrolou

Dva jazyky, tmavý režim, analytika respektující souhlas, sledování chyb a strukturované logy, e-maily, plánované úlohy a web servírovaný z CDN.

  • Čeština a angličtina
  • Designový systém a tmavý režim
  • Analytika se souhlasem
  • Chyby a logy
  • Transakční e-maily
  • Úlohy na pozadí
  • Rychlý marketingový web

Stavěno pro další vývoj — s Claude Code

Testy na čtyřech úrovních, agenti, kteří plánují a implementují, pravidla a hooky, které je drží v mezích, a průvodce, který nový projekt nastaví najednou.

  • Testy na čtyřech úrovních
  • Ukázková data a scénáře
  • Agenti pro Claude Code
  • Nastavení jedním příkazem
  • Zpětné přenášení vylepšení
  • Zdraví kódu
Prohlédnout všech 34 funkcí

Kvalita v číslech

Otestováno na každé úrovni

Každé číslo níže počítá skript přímo z repozitáře, nikdo ho nepíše ručně — mění se spolu s testy.

1 865automatických testů a přibývají

Jednotkové testy
1 210
Čistá logika a komponenty, ověřené během vteřin při každém commitu.
Databázové integrační testy
340
Každá procedura API proti skutečnému Postgresu: běžný průběh, oprávnění i auditní stopa.
End-to-end testy
307
Skutečný prohlížeč proklikává produkční build jako reálné persony.
Snímky scénářů
127
Dlouhé průchody, které zachytí každý krok postupu — pro ukázky i dokumentaci.
Vizuální regresní testy
8
Snímky porovnávané po pixelech ve světlém i tmavém režimu, na počítači i telefonu.

Spočítáno v repozitáři dne 23. října 2026. Celkový součet zahrnuje testovací případy; snímky scénářů jsou kroky uvnitř několika dlouhých testů a do součtu nejdou.

Stavěno pro Claude

Claude s vaší aplikací pracuje — a pomáhá vám ji stavět

Dvě strany téže myšlenky: vaši uživatelé připojí Claude ke svým datům a vaši vývojáři nechají Claude Code dělat rutinní práci podle přísných pravidel.

Pro vaše uživatele: MCP server

Správce prostoru vytvoří API klíč a vloží jeden příkaz. Od té chvíle může Claude Code číst a vytvářet poznámky — nebo cokoli, co váš fork zpřístupní — s oprávněními daného člověka a každý zápis skončí v protokolu aktivit.

Příkaz, který aplikace ukáže po vytvoření klíče

claude mcp add --transport http boilerplate https://your-app.example/api/mcp --header "Authorization: Bearer <YOUR_API_KEY>"

Pro vaše vývojáře: agenti s mantinely

Repozitář je připravený pro Claude Code: jeden agent promění cíl v plán krok za krokem i s testy, druhý ho implementuje a hooky každou úpravu zformátují, zkontrolují a ověří typy.

  1. 1

    Plán

    tech-lead-planner si přečte pravidla a kód a napíše plán.

  2. 2

    Implementace

    engineer postupuje podle plánu a píše testy.

  3. 3

    Kontrola

    Hooky a npm run check zastaví vše, co není zelené.

Od forku k prvnímu nasazení za jedno odpoledne

Většinu času jen čekáte, než cloud doběhne.

  1. 1

    Spusťte průvodce

    Jeden skript zkopíruje boilerplate, přejmenuje ho, vytvoří projekty v Supabase a na Vercelu a provede první nasazení.

  2. 2

    Popište svůj produkt

    Vyplňte jednostránkový popis produktu. Kódovací agenti si ho přečtou před plánováním každé funkce, takže staví to, co myslíte.

  3. 3

    Stavějte na vzorech

    Přidávejte tabulky, stránky a oprávnění stejně jako ukázkové funkce — s jednotkovými, databázovými, end-to-end i scénářovými testy, které už jsou připravené.

Časté otázky

Krátké odpovědi na to, na co se lidé ptají nejdřív. Vše ostatní: založte issue nebo si přečtěte vývojářskou příručku v repozitáři.

Všechny otázky

Začněte stavět ještě dnes

Účet vytvoříte za minutu — magický odkaz, žádné heslo — a uvidíte prostředí, které dostanou vaši uživatelé.

Vytvořit účet