zerostarter 0.0.6

package/LICENSE.md

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,274 @@
+# 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 -->

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "zerostarter",
+  "version": "0.0.6",
+  "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:"
+  },
+  "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"
+  }
+}