create-vexcms 0.0.3

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-vexcms",
+  "version": "0.0.3",
+  "type": "module",
+  "bin": {
+    "create-vexcms": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.2.0",
+    "@inquirer/prompts": "^7.2.0",
+    "ora": "^8.1.0",
+    "sort-package-json": "^2.10.0",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "test": "vitest run"
+  }
+}

package/templates/base-nextjs/.prettierignore

@@ -0,0 +1,26 @@
+# Dependencies
+node_modules
+.pnp
+.pnp.*
+
+# Build outputs
+.next
+out
+dist
+build
+
+# Generated files
+convex/_generated
+
+# Package manager
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Environment
+.env*
+!.env.example
+
+# Misc
+.DS_Store
+*.pem

package/templates/base-nextjs/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": false,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "printWidth": 100
+}

package/templates/base-nextjs/README.md

@@ -0,0 +1,256 @@
+# Next.js + Better Auth + Convex + shadcn/ui Template
+
+A modern, production-ready SaaS template built with:
+
+- **[Next.js](https://nextjs.org)** - The React framework for production with App Router
+- **[Better Auth](https://www.better-auth.com/)** - Modern authentication with email/password and OAuth providers
+- **[Convex](https://convex.dev/)** - Real-time database and backend
+- **[shadcn/ui](https://ui.shadcn.com/)** - Beautifully designed components built on Radix UI
+- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework
+
+## Getting Started
+
+### 1. Prerequisites
+
+- Node.js 18+ and npm/pnpm/yarn installed
+- A Convex account (free at [convex.dev](https://convex.dev))
+
+### 2. Clone and Install
+
+```bash
+# Clone this template
+git clone <your-repo-url>
+cd <your-project-name>
+
+# Install dependencies
+npm install
+# or
+pnpm install
+# or
+yarn install
+```
+
+### 3. Environment Setup
+
+Copy the example environment file:
+
+```bash
+cp .env.example .env
+```
+
+### 4. Generate Better Auth Secret
+
+Generate a secure secret for Better Auth:
+
+```bash
+npm run secret:create
+# or
+pnpm secret:create
+# or
+yarn secret:create
+```
+
+This will generate a random 32-character hex string and copy it to your clipboard.
+
+### 5. Configure Convex
+
+#### Set up Convex project
+
+```bash
+npx convex dev
+```
+
+This will:
+
+- Create a new Convex project (or link to an existing one)
+- Generate your `CONVEX_URL` and `NEXT_PUBLIC_CONVEX_URL`
+- Start the Convex development server
+
+#### Add environment variables to Convex
+
+You need to add two critical environment variables to your Convex deployment via the [Convex Dashboard](https://dashboard.convex.dev):
+
+1. **BETTER_AUTH_SECRET**: Paste the secret you generated in step 4
+2. **SITE_URL**: Set to your application URL
+   - Development: `http://localhost:3000` (or whatever port your dev server uses)
+   - Production: Your production domain (e.g., `https://yourdomain.com`)
+
+To add these in the Convex Dashboard:
+
+1. Go to your project at [dashboard.convex.dev](https://dashboard.convex.dev)
+2. Navigate to "Settings" → "Environment Variables"
+3. Add both `BETTER_AUTH_SECRET` and `SITE_URL`
+
+### 6. Update Your .env File
+
+Update your `.env` file with the values from Convex setup:
+
+```env
+NODE_ENV=development
+
+# From Convex setup
+CONVEX_URL=https://your-deployment.convex.cloud
+NEXT_PUBLIC_CONVEX_URL=https://your-deployment.convex.cloud
+CONVEX_SITE_URL=https://your-deployment.convex.site
+NEXT_PUBLIC_CONVEX_SITE_URL=https://your-deployment.convex.site
+
+# Better Auth (same secret you added to Convex Dashboard)
+BETTER_AUTH_SECRET=your-generated-secret-here
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
+```
+
+### 7. Start Development
+
+```bash
+# Terminal 1: Run Convex dev server
+npx convex dev
+
+# Terminal 2: Run the application
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```
+
+Visit `http://localhost:3000` to see your application running.
+
+## Authentication Setup
+
+This project uses Better Auth for authentication.
+
+<!-- {{OAUTH_SETUP_GUIDE}} -->
+
+## Customizing Authentication
+
+### Adding OAuth Providers
+
+To add or modify OAuth providers:
+
+1. **Update Better Auth configuration** in `convex/auth/index.ts`:
+
+```typescript
+export const createAuth = (ctx: GenericActionCtx<DataModel>) => {
+  return betterAuth({
+    socialProviders: {
+      google: {
+        clientId: process.env.GOOGLE_CLIENT_ID!,
+        clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+        redirectURI: `${process.env.SITE_URL}/api/auth/callback/google`,
+      },
+      // Add more providers
+      github: {
+        clientId: process.env.GITHUB_CLIENT_ID!,
+        clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+      },
+    },
+    // ... rest of config
+  })
+}
+```
+
+2. **Add credentials to Convex Dashboard** as environment variables
+
+3. **Consult the Better Auth documentation** for provider-specific configuration:
+   - [Better Auth Providers](https://www.better-auth.com/docs/authentication/social-login)
+
+### Customizing User Schema
+
+To add custom fields to your user model:
+
+1. Update the `user.additionalFields` in `convex/auth/index.ts`
+2. Update your Convex schema accordingly
+3. See [Better Auth User Management](https://www.better-auth.com/docs/concepts/user-management) for details
+
+### Email/Password Configuration
+
+The template has email/password authentication enabled by default. To customize:
+
+- [Better Auth Email/Password Docs](https://www.better-auth.com/docs/authentication/email-password)
+- [Email Verification Setup](https://www.better-auth.com/docs/authentication/email-verification)
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── app/                    # Next.js App Router
+│   │   ├── (frontend)/        # Frontend routes group
+│   │   ├── api/               # API routes
+│   │   └── layout.tsx         # Root layout
+│   ├── auth/                  # Authentication components
+│   ├── components/            # React components
+│   ├── lib/                   # Utilities and helpers
+│   └── env.mjs                # Typed environment variables
+├── convex/                    # Convex backend
+│   ├── auth/                  # Better Auth integration
+│   ├── schema.ts              # Database schema
+│   └── *.ts                   # Convex functions (queries, mutations, actions)
+├── public/                    # Static assets
+└── .env                       # Environment variables (not committed)
+```
+
+## Development Scripts
+
+```bash
+npm run dev              # Start development server
+npm run build            # Build for production
+npm run start            # Start production server
+npm run lint             # Lint code
+npm run typecheck        # Type check without emitting
+npm run format           # Format code with Prettier
+npm run format:check     # Check code formatting
+npm run secret:create    # Generate a Better Auth secret
+```
+
+## Documentation Resources
+
+### Core Technologies
+
+- **Next.js**: [nextjs.org/docs](https://nextjs.org/docs)
+- **Better Auth**: [better-auth.com/docs](https://www.better-auth.com/docs)
+- **Convex**: [docs.convex.dev](https://docs.convex.dev)
+- **shadcn/ui**: [ui.shadcn.com](https://ui.shadcn.com)
+- **Tailwind CSS**: [tailwindcss.com/docs](https://tailwindcss.com/docs)
+
+### Integration Guides
+
+- **Better Auth + Convex**: [better-auth.com/docs/integrations/convex](https://www.better-auth.com/docs/integrations/convex)
+- **Better Auth + Next.js**: [better-auth.com/docs/integrations/nextjs](https://www.better-auth.com/docs/integrations/nextjs)
+
+## Deployment
+
+### Deploy to Production
+
+1. **Deploy Convex Backend**:
+
+```bash
+npx convex deploy
+```
+
+2. **Update Convex environment variables** in production:
+   - Set `SITE_URL` to your production domain
+   - Keep `BETTER_AUTH_SECRET` the same (or rotate it)
+
+3. **Deploy your application** to your hosting provider (Vercel recommended):
+
+For Vercel:
+
+```bash
+npm install -g vercel
+vercel
+```
+
+Or connect your GitHub repository to Vercel for automatic deployments.
+
+4. **Update environment variables** in your hosting provider with production values:
+   - `NEXT_PUBLIC_CONVEX_URL`
+   - `NEXT_PUBLIC_CONVEX_SITE_URL`
+   - `NEXT_PUBLIC_SITE_URL`
+   - `BETTER_AUTH_SECRET`
+
+See [Next.js Deployment](https://nextjs.org/docs/app/building-your-application/deploying) and [Convex Production Deployment](https://docs.convex.dev/production/hosting) for detailed deployment instructions.
+
+## License
+
+MIT

package/templates/base-nextjs/_gitignore

@@ -0,0 +1,2 @@
+
+.env.local

package/templates/base-nextjs/components.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-vega",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "~/components",
+    "utils": "~/lib/utils",
+    "ui": "~/components/ui",
+    "lib": "~/lib",
+    "hooks": "~/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/templates/base-nextjs/convex/_generated/api.d.ts

@@ -0,0 +1,125 @@
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type * as auth_adapter_index from "../auth/adapter/index.js";
+import type * as auth_adapter_utils from "../auth/adapter/utils.js";
+import type * as auth_api from "../auth/api.js";
+import type * as auth_config from "../auth/config.js";
+import type * as auth_db from "../auth/db.js";
+import type * as auth_index from "../auth/index.js";
+import type * as auth_options from "../auth/options.js";
+import type * as auth_plugins_index from "../auth/plugins/index.js";
+import type * as auth_sessions from "../auth/sessions.js";
+import type * as http from "../http.js";
+import type * as vex_api_articles from "../vex/api/articles.js";
+import type * as vex_api_categories from "../vex/api/categories.js";
+import type * as vex_api_footers from "../vex/api/footers.js";
+import type * as vex_api_headers from "../vex/api/headers.js";
+import type * as vex_api_index from "../vex/api/index.js";
+import type * as vex_api_media from "../vex/api/media.js";
+import type * as vex_api_pages from "../vex/api/pages.js";
+import type * as vex_api_posts from "../vex/api/posts.js";
+import type * as vex_api_themes from "../vex/api/themes.js";
+import type * as vex_api_user from "../vex/api/user.js";
+import type * as vex_auth from "../vex/auth.js";
+import type * as vex_collections from "../vex/collections.js";
+import type * as vex_impersonation from "../vex/impersonation.js";
+import type * as vex_media from "../vex/media.js";
+import type * as vex_migrate from "../vex/migrate.js";
+import type * as vex_model_api_articles from "../vex/model/api/articles.js";
+import type * as vex_model_api_categories from "../vex/model/api/categories.js";
+import type * as vex_model_api_footers from "../vex/model/api/footers.js";
+import type * as vex_model_api_headers from "../vex/model/api/headers.js";
+import type * as vex_model_api_media from "../vex/model/api/media.js";
+import type * as vex_model_api_pages from "../vex/model/api/pages.js";
+import type * as vex_model_api_posts from "../vex/model/api/posts.js";
+import type * as vex_model_api_themes from "../vex/model/api/themes.js";
+import type * as vex_model_api_user from "../vex/model/api/user.js";
+import type * as vex_model_collections from "../vex/model/collections.js";
+import type * as vex_model_media from "../vex/model/media.js";
+import type * as vex_model_versions from "../vex/model/versions.js";
+import type * as vex_previewSnapshot from "../vex/previewSnapshot.js";
+import type * as vex_versions from "../vex/versions.js";
+
+import type {
+  ApiFromModules,
+  FilterApi,
+  FunctionReference,
+} from "convex/server";
+
+declare const fullApi: ApiFromModules<{
+  "auth/adapter/index": typeof auth_adapter_index;
+  "auth/adapter/utils": typeof auth_adapter_utils;
+  "auth/api": typeof auth_api;
+  "auth/config": typeof auth_config;
+  "auth/db": typeof auth_db;
+  "auth/index": typeof auth_index;
+  "auth/options": typeof auth_options;
+  "auth/plugins/index": typeof auth_plugins_index;
+  "auth/sessions": typeof auth_sessions;
+  http: typeof http;
+  "vex/api/articles": typeof vex_api_articles;
+  "vex/api/categories": typeof vex_api_categories;
+  "vex/api/footers": typeof vex_api_footers;
+  "vex/api/headers": typeof vex_api_headers;
+  "vex/api/index": typeof vex_api_index;
+  "vex/api/media": typeof vex_api_media;
+  "vex/api/pages": typeof vex_api_pages;
+  "vex/api/posts": typeof vex_api_posts;
+  "vex/api/themes": typeof vex_api_themes;
+  "vex/api/user": typeof vex_api_user;
+  "vex/auth": typeof vex_auth;
+  "vex/collections": typeof vex_collections;
+  "vex/impersonation": typeof vex_impersonation;
+  "vex/media": typeof vex_media;
+  "vex/migrate": typeof vex_migrate;
+  "vex/model/api/articles": typeof vex_model_api_articles;
+  "vex/model/api/categories": typeof vex_model_api_categories;
+  "vex/model/api/footers": typeof vex_model_api_footers;
+  "vex/model/api/headers": typeof vex_model_api_headers;
+  "vex/model/api/media": typeof vex_model_api_media;
+  "vex/model/api/pages": typeof vex_model_api_pages;
+  "vex/model/api/posts": typeof vex_model_api_posts;
+  "vex/model/api/themes": typeof vex_model_api_themes;
+  "vex/model/api/user": typeof vex_model_api_user;
+  "vex/model/collections": typeof vex_model_collections;
+  "vex/model/media": typeof vex_model_media;
+  "vex/model/versions": typeof vex_model_versions;
+  "vex/previewSnapshot": typeof vex_previewSnapshot;
+  "vex/versions": typeof vex_versions;
+}>;
+
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export declare const api: FilterApi<
+  typeof fullApi,
+  FunctionReference<any, "public">
+>;
+
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export declare const internal: FilterApi<
+  typeof fullApi,
+  FunctionReference<any, "internal">
+>;
+
+export declare const components: {};

package/templates/base-nextjs/convex/_generated/api.js

@@ -0,0 +1,23 @@
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import { anyApi, componentsGeneric } from "convex/server";
+
+/**
+ * A utility for referencing Convex functions in your app's API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api = anyApi;
+export const internal = anyApi;
+export const components = componentsGeneric();

package/templates/base-nextjs/convex/_generated/dataModel.d.ts

@@ -0,0 +1,60 @@
+/* eslint-disable */
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type {
+  DataModelFromSchemaDefinition,
+  DocumentByName,
+  TableNamesInDataModel,
+  SystemTableNames,
+} from "convex/server";
+import type { GenericId } from "convex/values";
+import schema from "../schema.js";
+
+/**
+ * The names of all of your Convex tables.
+ */
+export type TableNames = TableNamesInDataModel<DataModel>;
+
+/**
+ * The type of a document stored in Convex.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Doc<TableName extends TableNames> = DocumentByName<
+  DataModel,
+  TableName
+>;
+
+/**
+ * An identifier for a document in Convex.
+ *
+ * Convex documents are uniquely identified by their `Id`, which is accessible
+ * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
+ *
+ * Documents can be loaded using `db.get(tableName, id)` in query and mutation functions.
+ *
+ * IDs are just strings at runtime, but this type can be used to distinguish them from other
+ * strings when type checking.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Id<TableName extends TableNames | SystemTableNames> =
+  GenericId<TableName>;
+
+/**
+ * A type describing your Convex data model.
+ *
+ * This type includes information about what tables you have, the type of
+ * documents stored in those tables, and the indexes defined on them.
+ *
+ * This type is used to parameterize methods like `queryGeneric` and
+ * `mutationGeneric` to make them type-safe.
+ */
+export type DataModel = DataModelFromSchemaDefinition<typeof schema>;