zerostarter 0.0.6 → 0.0.8-canary.0

package/dist/bin/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/bin/index.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import{n as e,t}from"../convert-BzMTXW9D.mjs";import{basename as n,join as r,resolve as i}from"node:path";import{existsSync as a,readdirSync as o}from"node:fs";import{createInterface as s}from"node:readline/promises";import{parseArgs as c}from"node:util";import{execFileSync as l}from"node:child_process";var u={name:`zerostarter`,version:`0.0.8-canary.0`,description:`Go from zero to a production-ready SaaS, rebranded and ready to ship.`,keywords:[`cli`,`saas`,`scaffold`,`starter`,`template`,`zerostarter`],homepage:`https://github.com/nrjdalal/zerostarter#readme`,bugs:`https://github.com/nrjdalal/zerostarter/issues`,license:`MIT`,author:{name:`Neeraj Dalal`,email:`admin@nrjdalal.com`,url:`https://nrjdalal.com`},repository:`nrjdalal/zerostarter`,funding:`https://github.com/sponsors/nrjdalal`,bin:{zerostarter:`dist/bin/index.mjs`},files:[`dist`],type:`module`,types:`./dist/index.d.mts`,exports:`./dist/index.mjs`,scripts:{build:`tsdown`,"check-types":`tsc --noEmit`,dev:`tsdown --watch`,test:`bun test`},devDependencies:{"@packages/config":`workspace:*`,"@types/bun":`catalog:`,"@types/node":`catalog:`,tsdown:`catalog:`,typescript:`catalog:`}};const d=()=>!!(process.stdin.isTTY&&process.stdout.isTTY),f=(e,t=e)=>process.stdout.isTTY?`\x1b]8;;${e}\x07${t}\x1b]8;;\x07`:e,p=(e,t=process.stdout)=>n=>t.isTTY?`\x1b[${e}m${n}\x1b[0m`:n,m=p(`38;5;208`),h=p(`38;2;63;185;80`),g=p(`38;2;210;153;34`),_=p(`38;2;248;81;73`,process.stderr),v=async(e,t=``)=>{let n=s({input:process.stdin,output:process.stdout});try{return(await n.question(`${e}${t?` (${t})`:``}: `)).trim()||t}finally{n.close()}},y=async(e,t=!0)=>{let n=s({input:process.stdin,output:process.stdout});try{let r=(await n.question(`${e} (${t?`Y/n`:`y/N`}) `)).trim().toLowerCase();return r?r===`y`||r===`yes`:t}finally{n.close()}},b=(e,t,n)=>l(e,t,{cwd:n,encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`]}),x=(e,t=`main`)=>{b(`bunx`,[`gitpick@5.4.1`,`https://github.com/nrjdalal/zerostarter/tree/${t}`,e])},S=e=>{b(`bun`,[`install`],e)},C=e=>{b(`git`,[`init`,`-q`],e)},w=(e,t)=>{b(`git`,[`add`,`-A`],e);try{b(`git`,[`commit`,`--no-verify`,`-q`,`-m`,t],e)}catch{}},T=e=>!a(e)||o(e).filter(e=>e!==`.git`).length===0,E=t=>e(r(t,`packages/config/src/site.ts`)),D=async a=>{let{positionals:o,values:s}=c({allowPositionals:!0,args:a,options:{"dry-run":{type:`boolean`},help:{short:`h`,type:`boolean`},yes:{short:`y`,type:`boolean`}}});if(s.help){console.log(`Usage:
+  $ zerostarter init [dir] [options]
+
+Scaffold ZeroStarter into dir (default .) as a fresh product. The author's
+content, public assets, and agent skills are left out for you to supply; the
+dir name becomes the project name and site.ts + package.json are rebranded. If
+the dir already holds a ZeroStarter clone it is used in place; otherwise the
+latest ZeroStarter is fetched into it first.
+
+Options:
+  -y, --yes      Skip prompts; fail instead of prompting when input is needed
+      --dry-run  Print the plan without writing anything
+  -h, --help     Display help`);return}let l=d()&&!s.yes,u=o[0]??`.`,f=i(u),p=E(f);if(!p&&!T(f)){if(!l)throw Error(`Target directory is not empty. Pass an empty target dir, for example: zerostarter init my-product`);let e=await v(`Target directory is not empty. New project directory`);if(!e)throw Error(`No directory name provided.`);u=e}let _=i(u),b=n(_),D={name:b};if(s[`dry-run`]){console.log(`zerostarter init (dry run)`),console.log(`  target: ${_}`),console.log(`  name:   ${b}`),console.log(`  mode:   ${E(_)?`in place`:`fetch first`}`);return}if(p&&l&&!await y(g(`Convert ${_} in place? This rewrites files and commits.`),!1)){console.log(`Aborted.`);return}E(_)||(console.log(`Fetching the latest ZeroStarter ...`),x(_)),e(r(_,`.git`))||(C(_),w(_,`chore: scaffold from zerostarter`)),console.log(`Removing starter content and rebranding ...`),t(_,D),console.log(`Installing dependencies ...`),S(_),w(_,`chore: re-baseline as ${b}`);let O=[[`packages/config/src/site.ts`,`your brand: name, tagline, links`],[`web/next/content`,`your docs and blog`],[`web/next/public`,`your logo and assets`]];console.log(`\n${h(`✓`)} ${b} is ready.\n`),console.log(`Next steps:`),_!==process.cwd()&&console.log(`  ${m(`cd ${u}`)}`),console.log(`  ${m(`cp .env.example .env`)}  # add your secrets`),console.log(`  ${m(`bun dev`)}`),console.log(`
+Make it yours:`);for(let[e,t]of O)console.log(`  ${e.padEnd(29)} ${t}`)},O=async e=>{console.log(`zerostarter sync is not implemented yet.`),console.log(`Planned: a gitpick overlay of the latest zerostarter onto an existing fork, then a`),console.log(`prune of starter-only artifacts while preserving the fork's product and branding.`)},{author:k,name:A,version:j}=u,M=`Version:
+  ${A}@${j}
+
+Go from zero to a production-ready SaaS, rebranded and ready to ship.
+
+Usage:
+  $ ${A} <command> [options]
+
+Commands:
+  init [dir]     Scaffold ZeroStarter into dir (default .) as a fresh product.
+                 The dir name becomes the project name.
+  sync           Re-baseline an existing fork on ZeroStarter's latest scaffold
+
+Options:
+  -v, --version  Display version
+  -h, --help     Display help
+
+Author:
+  ${k.name} <${k.email}> (${f(k.url)})`;(async()=>{try{let e=process.argv.slice(2),t=e[0],n=e.slice(1);switch(t){case`init`:return await D(n);case`sync`:return await O(n);case void 0:case`-h`:case`--help`:console.log(M);return;case`-v`:case`--version`:console.log(`${A}@${j}`);return;default:console.error(_(`Unknown command: ${t}\n`)),console.log(M),process.exit(1)}}catch(e){console.error(_(e instanceof Error?e.message:String(e))),process.exit(1)}})();export{};

package/dist/convert-BzMTXW9D.mjs

@@ -0,0 +1,110 @@
+import{dirname as e,join as t}from"node:path";import{existsSync as n,mkdirSync as r,readFileSync as i,rmSync as a,writeFileSync as o}from"node:fs";const s=e=>n(e),c=e=>i(e,`utf8`),l=(t,n)=>{r(e(t),{recursive:!0}),o(t,n)},u=e=>{a(e,{force:!0,recursive:!0})},d=e=>JSON.parse(c(e)),f=(e,t)=>{l(e,`${JSON.stringify(t,null,2)}\n`)},p=(e,t)=>{if(!n(e))return!1;let r=c(e),i=r;for(let[e,n]of t)i=i.split(e).join(n);return i===r?!1:(o(e,i),!0)},m=({name:e})=>{let t=e.charAt(0).toUpperCase()+e.slice(1);return`// Brand identity for this app: the single source a fork edits to rebrand. web reads it via lib/config.ts.
+export const site = {
+  name: "${t}",
+  description: "${t} is just getting started. Tell its story here.",
+  tagline: "Your tagline, ready when you are.",
+  social: {
+    github: "",
+    x: "",
+    discord: "",
+  },
+  // Local-only dev agent identity (api/hono agents router).
+  agent: {
+    name: "LocalAgent",
+    email: "agent@local.host",
+  },
+  // Injectable long-form text blocks. A product sets its own, or leaves them empty.
+  apiReferenceDescription: "",
+  llmsFullPreamble: "",
+} as const
+
+export type Site = typeof site
+`},h=()=>`import { redirect } from "next/navigation"
+
+// Fresh fork: redirect to the waitlist until you build your real home page.
+export default function Home() {
+  redirect("/waitlist")
+}
+`,g=()=>`# AGENTS.md
+
+Guidance for AI coding agents working in this repository.
+`,_=()=>`---
+slug: /docs
+title: Introduction
+description: Documentation.
+---
+
+# Introduction
+
+This is your documentation home. Start writing, this page is yours.
+`,v=()=>`---
+slug: /console/docs
+title: Introduction
+description: Internal documentation.
+---
+
+# Introduction
+
+Your team's internal docs live here.
+`,y=e=>`---
+title: Blog
+description: Latest articles and updates
+createdAt: ${e}
+---
+
+## Recent Posts
+
+<BlogPostList />
+`,b=e=>`---
+title: Hello World
+description: The first post on your new blog.
+createdAt: ${e}
+publishedAt: ${e}
+---
+
+## Hello World
+
+Your very first post. Replace it with something worth reading.
+`,x=()=>`import type { DocsConfig } from "./src/lib/docs/types"
+
+const docsConfig = {
+  docs: {
+    "Getting Started": [
+      {
+        "/docs": {
+          title: "Introduction",
+          description: "Documentation.",
+        },
+      },
+    ],
+  },
+  console: {
+    "Getting Started": [
+      {
+        "/console/docs": {
+          title: "Introduction",
+          description: "Internal documentation.",
+        },
+      },
+    ],
+  },
+} satisfies DocsConfig
+
+export default docsConfig
+`,S=(e,...n)=>t(e,...n),C=e=>e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)||`app`,w=[`web/next/content`,`web/next/public`,`.agents/skills`,`.claude/skills`,`.github/skills`],T=[`packages/cli`,`.github/workflows/cli-release.yml`,`.github/audit`,`.github/reviews`,`.infisical.json`,`.github/assets/graph-build.svg`,`.github/assets/cli.tape`,`.github/assets/setup.sh`,`.github/assets/cli.gif`,`.github/FUNDING.yml`,`LICENSE.md`,`CHANGELOG.md`,`bun.lock`,`skills-lock.json`,`web/next/src/app/hire`,`web/next/src/app/resume`,`web/next/src/fonts/caveat-latin-wght-normal.woff2`,`web/next/src/fonts/newsreader-latin-wght-normal.woff2`,`web/next/src/fonts/newsreader-latin-wght-italic.woff2`],E=e=>{let t=new Date,n=t.toISOString().slice(0,10),r=[t.getFullYear(),t.getMonth()+1,t.getDate()].map(e=>String(e).padStart(2,`0`)).join(`-`),i=r<n?r:n;l(S(e,`web/next/content/docs/index.mdx`),_()),l(S(e,`web/next/content/blog/index.mdx`),y(i)),l(S(e,`web/next/content/blog/hello-world.mdx`),b(i)),l(S(e,`web/next/content/console/docs/index.mdx`),v()),l(S(e,`web/next/docs.config.ts`),x()),l(S(e,`web/next/public/.gitkeep`),``),l(S(e,`web/next/src/app/page.tsx`),h()),l(S(e,`AGENTS.md`),g())},D=e=>{let t=p(S(e,`web/next/src/components/navbar/home.tsx`),[[`    { href: "/hire", label: "Hire" },
+`,``]]),n=p(S(e,`web/next/src/lib/fonts.ts`),[[`
+export const caveat = localFont({
+  src: "../fonts/caveat-latin-wght-normal.woff2",
+  variable: "--font-caveat",
+  weight: "400 700",
+})
+`,``]]),r=p(S(e,`web/next/src/lib/fonts.ts`),[[`
+export const newsreader = localFont({
+  src: [
+    { path: "../fonts/newsreader-latin-wght-normal.woff2", style: "normal" },
+    { path: "../fonts/newsreader-latin-wght-italic.woff2", style: "italic" },
+  ],
+  variable: "--font-newsreader",
+  weight: "200 800",
+})
+`,``]]);if(!n||!r)throw Error(`fonts.ts: caveat/newsreader exports not found, but their woff2 files were removed (template drift). Update packages/cli/src/convert.ts.`);if(!t)throw Error(`navbar/home.tsx: /hire entry not found (template drift). Update packages/cli/src/convert.ts.`)},O=(e,t)=>{l(S(e,`packages/config/src/site.ts`),m(t));let n=S(e,`package.json`),r=d(n);r.name=C(t.name),r.version=`0.0.0`,delete r.homepage,delete r.bugs,delete r.license,delete r.author,delete r.repository,delete r.funding,f(n,r)},k=(e,t)=>{for(let t of[...w,...T])u(S(e,t));E(e),D(e),O(e,t)};export{s as n,k as t};

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+//#region src/templates.d.ts
+interface Brand {
+  name: string;
+}
+//#endregion
+//#region src/convert.d.ts
+declare const convertRepo: (root: string, brand: Brand) => void;
+//#endregion
+export { type Brand, convertRepo };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"./convert-BzMTXW9D.mjs";export{e as convertRepo};

package/package.json

@@ -1,140 +1,32 @@
 {
   "name": "zerostarter",
-  "version": "0.0.6",
+  "version": "0.0.8-canary.0",
+  "description": "Go from zero to a production-ready SaaS, rebranded and ready to ship.",
+  "keywords": [
+    "cli",
+    "saas",
+    "scaffold",
+    "starter",
+    "template",
+    "zerostarter"
+  ],
   "homepage": "https://github.com/nrjdalal/zerostarter#readme",
   "bugs": "https://github.com/nrjdalal/zerostarter/issues",
-  "repository": "nrjdalal/zerostarter",
-  "funding": "https://github.com/sponsors/nrjdalal",
   "license": "MIT",
-  "files": [],
   "author": {
     "name": "Neeraj Dalal",
     "email": "admin@nrjdalal.com",
     "url": "https://nrjdalal.com"
   },
-  "workspaces": [
-    "api/*",
-    "packages/*",
-    "web/*"
-  ],
-  "scripts": {
-    "build": "turbo build --summarize",
-    "check-types": "SKIP_ENV_VALIDATION=true turbo check-types --summarize",
-    "clean": "bunx rimraf --glob \"**/.next\" \"**/.source\" \"**/.turbo\" \"**/dist\" \"**/node_modules\" && bunx delete-empty",
-    "db:generate": "turbo build --filter=@packages/* && bun --cwd packages/db drizzle-kit generate",
-    "db:migrate": "turbo build --filter=@packages/* && bun --cwd packages/db drizzle-kit migrate",
-    "db:studio": "turbo build --filter=@packages/* && bun --cwd packages/db drizzle-kit studio",
-    "predev": "turbo build --filter=@packages/*",
-    "dev": "turbo dev --ui tui",
-    "devtools": "turbo devtools",
-    "format": "prettier --write --ignore-unknown *",
-    "postinstall": "bun .github/scripts/deps-manager.ts",
-    "lint": "turbo lint --summarize",
-    "prepare": "bunx simple-git-hooks",
-    "start": "turbo start"
-  },
-  "simple-git-hooks": {
-    "pre-commit": "bunx lint-staged --verbose && bun run build",
-    "commit-msg": "bunx commitlint --edit $1"
-  },
-  "commitlint": {
-    "extends": [
-      "@commitlint/config-conventional"
-    ]
-  },
-  "lint-staged": {
-    "*": [
-      "oxlint",
-      "prettier --write --ignore-unknown"
-    ],
-    "package.json": [
-      "bun .github/scripts/deps-manager.ts",
-      "sort-package-json"
-    ]
-  },
-  "prettier": {
-    "printWidth": 100,
-    "semi": false
-  },
-  "devDependencies": {
-    "@commitlint/cli": "catalog:",
-    "@commitlint/config-conventional": "catalog:",
-    "@ianvs/prettier-plugin-sort-imports": "catalog:",
-    "@octokit/rest": "catalog:",
-    "@types/bun": "catalog:",
-    "@types/node": "catalog:",
-    "globby": "catalog:",
-    "lint-staged": "catalog:",
-    "oxlint": "catalog:",
-    "prettier": "catalog:",
-    "prettier-plugin-tailwindcss": "catalog:",
-    "simple-git-hooks": "catalog:",
-    "sort-package-json": "catalog:",
-    "turbo": "catalog:"
+  "repository": "nrjdalal/zerostarter",
+  "funding": "https://github.com/sponsors/nrjdalal",
+  "bin": {
+    "zerostarter": "dist/bin/index.mjs"
   },
-  "packageManager": "bun@1.3.5",
-  "catalog": {
-    "@commitlint/cli": "^20.2.0",
-    "@commitlint/config-conventional": "^20.2.0",
-    "@fontsource-variable/dm-sans": "^5.2.8",
-    "@fontsource-variable/jetbrains-mono": "^5.2.8",
-    "@hono/zod-validator": "^0.7.6",
-    "@hookform/resolvers": "^5.2.2",
-    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
-    "@octokit/rest": "^22.0.1",
-    "@remixicon/react": "^4.7.0",
-    "@t3-oss/env-core": "^0.13.10",
-    "@tailwindcss/postcss": "^4.1.18",
-    "@tanstack/react-form": "^1.27.6",
-    "@tanstack/react-query": "^5.90.12",
-    "@tanstack/react-query-devtools": "^5.91.1",
-    "@types/bun": "latest",
-    "@types/mdx": "^2.0.13",
-    "@types/node": "latest",
-    "@types/react": "^19.2.1",
-    "@types/react-dom": "^19.2.1",
-    "babel-plugin-react-compiler": "^1.0.0",
-    "better-auth": "^1.4.9",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "cmdk": "^1.1.1",
-    "concurrently": "^9.2.1",
-    "date-fns": "^4.1.0",
-    "dotenv": "^17.2.3",
-    "drizzle-kit": "^0.31.8",
-    "drizzle-orm": "^0.45.1",
-    "embla-carousel-react": "^8.6.0",
-    "fumadocs-core": "^16.3.2",
-    "fumadocs-mdx": "^14.2.2",
-    "fumadocs-ui": "^16.3.2",
-    "globby": "^16.1.0",
-    "hono": "^4.11.1",
-    "input-otp": "^1.4.2",
-    "lint-staged": "^16.2.7",
-    "lucide-react": "^0.562.0",
-    "next": "^16.1.1",
-    "next-themes": "^0.4.6",
-    "oxlint": "^1.35.0",
-    "postgres": "^3.4.7",
-    "prettier": "^3.7.4",
-    "prettier-plugin-tailwindcss": "^0.7.2",
-    "radix-ui": "^1.4.3",
-    "react": "^19.2.3",
-    "react-day-picker": "^9.13.0",
-    "react-dom": "^19.2.3",
-    "react-hook-form": "^7.69.0",
-    "react-resizable-panels": "^3.0.6",
-    "recharts": "2.15.4",
-    "simple-git-hooks": "^2.13.1",
-    "sonner": "^2.0.7",
-    "sort-package-json": "^3.6.0",
-    "tailwind-merge": "^3.4.0",
-    "tailwindcss": "^4.1.18",
-    "tsdown": "^0.18.2",
-    "turbo": "^2.7.1",
-    "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3",
-    "vaul": "^1.1.2",
-    "zod": "^4.2.1"
-  }
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": "./dist/index.mjs"
 }

package/LICENSE.md

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Neeraj Dalal
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,274 +0,0 @@
-# ZeroStarter - The SaaS Starter
-
-A modern, type-safe, and high-performance SaaS starter template built with a monorepo architecture.
-
-- **📚 Documentation**: For comprehensive documentation, visit **[https://zerostarter.dev/docs](https://zerostarter.dev/docs)**.
-- **🤖 AI/LLM Users**: For optimized documentation, use **[https://zerostarter.dev/llms.txt](https://zerostarter.dev/llms.txt)**.
-- **🐦 X**: Follow **[@nrjdalal](https://twitter.com/nrjdalal)** for updates and don't forget to star the repository!
-
-> [!IMPORTANT]
-> **Release Candidate (RC) Status**: ZeroStarter is currently in **Release Candidate (RC)** status. All implemented features are stable and production-ready. We're actively adding new features and integrations day-by-day.
-
-<!--
-```bash
-npx turbo run build --graph=graph.svg
-sed -i '' 's/\[root\] //g; s/#build//g; s/___ROOT___/ZeroStarter/g' graph.svg
-sed -i '' 's/fill="white"/fill="none"/g; s/fill="#ffffff"/fill="none"/g; s/fill="#fff"/fill="none"/g' graph.svg
-sed -i '' 's/fill="black"/fill="#1f6feb"/g' graph.svg
-sed -i '' 's/stroke="[^"]*"/stroke="#1f6feb"/g; s/stroke:[^;]*;/stroke:#1f6feb;/g' graph.svg
-sed -i '' 's/<text\([^>]*\)>/<text\1 fill="#1f6feb">/g' graph.svg
-sed -i '' 's/stroke="#1f6feb" points="-4,4/stroke="none" points="-4,4/g' graph.svg
-mkdir -p .github/assets
-mv graph.svg .github/assets/graph-build.svg
-```
--->
-
-## Architecture and Tech Stack
-
-![Graph Build](./.github/assets/graph-build.svg)
-
-- **Runtime & Build System**: [Bun](https://bun.sh) + [Turborepo](https://turbo.build)
-- **Frontend**: [Next.js 16](https://nextjs.org)
-- **Backend**: [Hono](https://hono.dev)
-- **RPC**: [Hono Client](https://hono.dev/docs/guides/rpc) for end-to-end type safety with frontend client
-- **Database**: [PostgreSQL](https://www.postgresql.org) with [Drizzle ORM](https://orm.drizzle.team)
-- **Authentication**: [Better Auth](https://better-auth.com)
-- **Styling**: [Tailwind CSS](https://tailwindcss.com)
-- **UI Components**: [Shadcn UI](https://ui.shadcn.com)
-- **Data Fetching**: [TanStack Query](https://tanstack.com/query/latest)
-- **Validation**: [Zod](https://zod.dev)
-- **Bundling, Linting & Formatting**: [tsdown](https://tsdown.dev), [Oxlint](https://oxc.rs/docs/guide/usage/linter) and [Prettier](https://prettier.io)
-- **Documentation**: [Fumadocs](https://fumadocs.dev) with auto-generated [llms.txt](https://zerostarter.dev/llms.txt)
-- **Automated Releases**: Automatically updated [Changelog](https://github.com/nrjdalal/zerostarter/releases) on release
-
-### Future Stack and Features
-
-- **AI**
-  - [ ] [Vercel AI SDK](https://ai-sdk.dev)
-- **Analytics**:
-  - [ ] [Posthog](https://posthog.com)
-- **Background Tasks**:
-  - [ ] [Inngest](https://www.inngest.com)
-  - [ ] [Trigger.dev](https://trigger.dev)
-- **Email**:
-  - [ ] [Resend](https://resend.com)
-  - [ ] [SendGrid](https://sendgrid.com)
-- **OpenAPI**:
-  - [ ] [Scalar](https://scalar.com)
-- **Organization/teams**:
-  - [ ] [Better Auth](https://www.better-auth.com/docs/plugins/organization)
-- **Internationalization**:
-  - [ ] [i18next](https://www.i18next.com)
-  - [ ] [next-intl](https://next-intl.dev)
-- **Payment Processing**:
-  - [ ] [Autumn](https://useautumn.com)
-  - [ ] [Creem](https://www.creem.io)
-  - [ ] [Dodo](https://dodopayments.com)
-  - [ ] [Lemon Squeezy](https://www.lemonsqueezy.com)
-  - [ ] [Paddle](https://www.paddle.com)
-  - [ ] [Polar](https://polar.sh)
-  - [ ] [Razorpay](https://razorpay.com)
-  - [ ] [Stripe](https://stripe.com)
-
----
-
-## 📂 Project Structure
-
-This project is a monorepo organized as follows:
-
-```
-.
-├── api/
-│   └── hono/      # Backend API server (Hono)
-├── web/
-│   └── next/      # Frontend application (Next.js)
-└── packages/
-    ├── auth/      # Shared authentication logic (Better Auth)
-    ├── db/        # Database schema and Drizzle configuration
-    ├── env/       # Type-safe environment variables
-    └── tsconfig/  # Shared TypeScript configuration
-```
-
----
-
-## 🔌 Type-Safe API Client
-
-This starter utilizes [Hono RPC](https://hono.dev/docs/guides/rpc) to provide end-to-end type safety between the backend and frontend.
-
-- **Backend**: Routes defined in `api/hono/src/routers` are exported as `AppType` at `api/hono/src/index.ts`.
-- **Frontend**: The client at `web/next/src/lib/api/client.ts` infers `AppType` request/response types using `hono/client`.
-
-### Usage Example
-
-```ts
-import { apiClient } from "@/lib/api/client"
-
-// Fully typed request and response
-const res = await apiClient.health.$get()
-const data = await res.json()
-```
-
----
-
-## ⚙️ Getting Started
-
-### Prerequisites
-
-- [Bun](https://bun.sh) (v1.3.0 or later)
-
-### Installation
-
-1. Clone this template:
-
-   ```bash
-   bunx gitpick https://github.com/nrjdalal/zerostarter/tree/main
-   cd zerostarter
-   ```
-
-   > **Note**: The `main` branch is the latest stable release.
-
-2. Install dependencies:
-
-   ```bash
-   bun install
-   ```
-
-   > **Note**: If the installation fails, try using `bun install --ignore-scripts`
-
-3. Set up environment variables:
-
-   Create a `.env` file in the root directory with the following variables:
-
-   ```
-   # -------------------- Server variables --------------------
-
-   HONO_APP_URL=http://localhost:4000
-   HONO_TRUSTED_ORIGINS=http://localhost:3000
-
-   # Generate using `openssl rand -base64 32`
-   BETTER_AUTH_SECRET=
-
-   # Generate at `https://github.com/settings/developers`
-   GITHUB_CLIENT_ID=
-   GITHUB_CLIENT_SECRET=
-
-   # Generate at `https://console.cloud.google.com/apis/credentials`
-   GOOGLE_CLIENT_ID=
-   GOOGLE_CLIENT_SECRET=
-
-   # Generate using `bunx pglaunch -k`
-   POSTGRES_URL=
-
-   # -------------------- Client variables --------------------
-
-   NEXT_PUBLIC_APP_URL=http://localhost:3000
-   NEXT_PUBLIC_API_URL=http://localhost:4000
-   ```
-
-### Database Setup
-
-1. Ensure your PostgreSQL server is running.
-2. Run the generation:
-
-   ```bash
-   bun run db:generate
-   ```
-
-3. Run the migration:
-
-   ```bash
-   bun run db:migrate
-   ```
-
-### Authentication Setup
-
-ZeroStarter comes with some default authentication plugins using [Better Auth](https://better-auth.com), you can extend as needed.
-
-#### Github
-
-1. Create a GitHub OAuth App at [GitHub Developer Settings](https://github.com/settings/developers).
-2. Set the **Homepage URL** to `http://localhost:3000`.
-3. Set the **Authorization callback URL** to `http://localhost:3000/api/auth/callback/github`.
-4. Copy the **Client ID** and **Client Secret** into your `.env` file.
-
-#### Google
-
-1. Create a Google OAuth App in the [Google Cloud Console](https://console.cloud.google.com/apis/credentials.
-2. Configure the OAuth consent screen (External).
-3. Create an **OAuth Client ID** (Application type: Web).
-4. Set the **Authorized JavaScript origins** to `http://localhost:3000`.
-5. Set the **Authorized redirect URI** to `http://localhost:4000/api/auth/callback/google`.
-6. Copy the **Client ID** and **Client Secret** into your `.env` file.
-
-### Running the Application
-
-```bash
-bun dev
-```
-
-### Running the Application with Docker Compose
-
-```bash
-docker compose up
-```
-
-### Accessing the Application
-
-- Frontend: [http://localhost:3000](http://localhost:3000)
-- Backend: [http://localhost:4000](http://localhost:4000)
-
----
-
-## 📜 Scripts
-
-### Development
-
-- `bun run dev`: Start the development servers.
-
-### Maintenance
-
-- `bun run clean`: Clean the cache and build artifacts.
-- `bun run lint`: Lint the codebase using Oxlint.
-- `bun run format`: Format the codebase using Prettier.
-- `bun run check-types`: Check the types of the codebase.
-
-### Production
-
-- `bun run build`: Build the applications.
-- `bun run start`: Start the production servers.
-
-### Database
-
-- `bun run db:generate`: Generate Drizzle migrations.
-- `bun run db:migrate`: Run Drizzle migrations.
-- `bun run db:studio`: Open Drizzle Studio to view/edit data.
-
-## 📖 Deployment
-
-- **Frontend**:
-  - [Vercel](.github/docs/deployment/vercel.md#vercel)
-- **Backend**:
-  - [Vercel](.github/docs/deployment/vercel.md#vercel-1)
-
-## 🤝 Contributing
-
-Contributions welcome — any help is appreciated!
-
-- Fork the repo and create a branch (use descriptive names, e.g. `feat/{name}` or `fix/{name}`).
-- Make your changes, add tests if applicable, and run the checks:
-  - `bun run build`
-  - `bun run check-types`
-  - `bun run format`
-  - `bun run lint`
-- Follow the existing code style and commit message conventions (use conventional commits: feat, fix, docs, chore).
-- Open a PR describing the change, motivation, and any migration notes; link related issues.
-- For breaking changes or large features, open an issue first to discuss the approach.
-- By contributing you agree to the MIT license and the project's Code of Conduct.
-
-Thank you for helping improve ZeroStarter!
-
-## 📄 License
-
-This project is licensed under the [MIT](https://github.com/nrjdalal/zerostarter/blob/canary/LICENSE.md) License.
-
-<!-- trigger build: 4 -->