create-varity-app 2.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Varity Labs
+
+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,85 @@
+# create-varity-app
+
+[![npm](https://img.shields.io/npm/v/create-varity-app)](https://www.npmjs.com/package/create-varity-app)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/varity-labs/varity-sdk/blob/main/LICENSE)
+
+Create production-ready apps with auth, database, and payments built in.
+
+## Quick Start
+
+```bash
+npx create-varity-app my-app
+cd my-app
+npm run dev
+```
+
+Or with other package managers:
+
+```bash
+pnpm create varity-app my-app
+yarn create varity-app my-app
+```
+
+## What You Get
+
+- **Next.js 15** app with TypeScript and Tailwind CSS
+- **Authentication** — email, social login, and more (zero config)
+- **Database** — ready-to-use collections with typed queries
+- **Dashboard** — professional layout with sidebar navigation
+- **Landing page** — hero, features, pricing, testimonials
+- **Settings** — profile, preferences, security, billing sections
+- **6 pages** — dashboard, projects, tasks, team, settings, login
+
+## Project Structure
+
+```
+my-app/
+├── src/
+│   └── app/
+│       ├── (auth)/login/     # Login page
+│       ├── (dashboard)/      # Protected dashboard pages
+│       │   ├── dashboard/    # Overview with KPIs
+│       │   ├── projects/     # Project management
+│       │   ├── tasks/        # Task tracking
+│       │   ├── team/         # Team members
+│       │   └── settings/     # App settings (6 sections)
+│       └── page.tsx          # Landing page
+├── tailwind.config.ts
+├── next.config.js
+└── package.json
+```
+
+## Deploy
+
+When you're ready to go live:
+
+```bash
+pip install varitykit
+varitykit app deploy
+```
+
+Your app will be live in under 60 seconds.
+
+Or deploy from your AI editor with the [Varity MCP server](../../cli/varity-mcp/) (`@varity-labs/mcp`) — just ask "deploy this project".
+
+## Related Packages
+
+- **[@varity-labs/sdk](../../core/varity-sdk/)** — Core SDK (database, credentials)
+- **[@varity-labs/ui-kit](../../ui/varity-ui-kit/)** — React UI components
+- **[@varity-labs/mcp](../../cli/varity-mcp/)** — MCP server for AI editors (Cursor, Claude Code, VS Code)
+
+## Learn More
+
+- [Documentation](https://docs.varity.so)
+- [GitHub](https://github.com/varity-labs/varity-sdk)
+- [Discord](https://discord.gg/varity)
+
+---
+
+**Part of the [Varity SDK](https://github.com/varity-labs/varity-sdk)** — Build, deploy, and monetize apps 70% cheaper than AWS.
+
+[Documentation](https://docs.varity.so) · [GitHub](https://github.com/varity-labs/varity-sdk) · [Discord](https://discord.gg/varity)
+
+## License
+
+MIT — [Varity Labs](https://varity.so)

package/dist/create.js

@@ -0,0 +1,141 @@
+import path from "path";
+import fs from "fs-extra";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import ora from "ora";
+import { getInstallCommand } from "./utils.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const VARITY_PACKAGE_VERSION = "^2.0.0-alpha.1";
+const WORKSPACE_DEPS = {
+    "@varity-labs/sdk": VARITY_PACKAGE_VERSION,
+    "@varity-labs/types": VARITY_PACKAGE_VERSION,
+    "@varity-labs/ui-kit": VARITY_PACKAGE_VERSION,
+};
+const EXCLUDED_FILES = new Set([
+    ".env.local",
+    ".env.development.local",
+    ".env.production.local",
+]);
+function getTemplateDir() {
+    return path.resolve(__dirname, "..", "template");
+}
+function rewritePackageJson(content, projectName) {
+    const pkg = { ...content };
+    pkg.name = projectName;
+    pkg.version = "0.1.0";
+    // Convert workspace:^ deps to real versions
+    for (const depKey of ["dependencies", "devDependencies"]) {
+        const deps = pkg[depKey];
+        if (!deps)
+            continue;
+        for (const [name, version] of Object.entries(deps)) {
+            if (typeof version === "string" &&
+                version.startsWith("workspace:")) {
+                deps[name] = WORKSPACE_DEPS[name] || VARITY_PACKAGE_VERSION;
+            }
+        }
+    }
+    // Remove monorepo-specific scripts
+    const scripts = pkg.scripts;
+    if (scripts) {
+        delete scripts.prepare; // husky install — not needed outside monorepo
+    }
+    return pkg;
+}
+export async function createApp(projectName, packageManager) {
+    const targetDir = path.resolve(process.cwd(), projectName);
+    const templateDir = getTemplateDir();
+    // Check template exists
+    if (!fs.existsSync(templateDir)) {
+        console.error(chalk.red("Error: Template not found. This is a bug — please report it at https://github.com/varity-labs/varity-sdk/issues"));
+        process.exit(1);
+    }
+    // Check target doesn't already exist
+    if (fs.existsSync(targetDir)) {
+        console.error(chalk.red(`Error: Directory ${chalk.bold(projectName)} already exists.`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(`  Creating ${chalk.bold(projectName)}...`);
+    console.log();
+    // Copy template
+    const copySpinner = ora("  Copying template").start();
+    try {
+        await fs.copy(templateDir, targetDir, {
+            filter: (src) => {
+                const basename = path.basename(src);
+                if (EXCLUDED_FILES.has(basename))
+                    return false;
+                if (basename === "node_modules")
+                    return false;
+                if (basename === ".next")
+                    return false;
+                return true;
+            },
+        });
+        // Rename gitignore → .gitignore (npm strips .gitignore from tarballs)
+        const gitignoreSrc = path.join(targetDir, "gitignore");
+        const gitignoreDst = path.join(targetDir, ".gitignore");
+        if (fs.existsSync(gitignoreSrc) && !fs.existsSync(gitignoreDst)) {
+            await fs.rename(gitignoreSrc, gitignoreDst);
+        }
+        // Rewrite package.json
+        const pkgPath = path.join(targetDir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            const pkgContent = await fs.readJson(pkgPath);
+            const rewritten = rewritePackageJson(pkgContent, projectName);
+            await fs.writeJson(pkgPath, rewritten, { spaces: 2 });
+        }
+        copySpinner.succeed("  Template copied");
+    }
+    catch (err) {
+        copySpinner.fail("  Failed to copy template");
+        throw err;
+    }
+    // Install dependencies
+    const installCmd = getInstallCommand(packageManager);
+    const installSpinner = ora(`  Installing dependencies (${packageManager})`).start();
+    try {
+        execSync(installCmd, {
+            cwd: targetDir,
+            stdio: "pipe",
+            env: { ...process.env, ADBLOCK: "1", DISABLE_OPENCOLLECTIVE: "1" },
+        });
+        installSpinner.succeed("  Dependencies installed");
+    }
+    catch {
+        installSpinner.warn(`  Could not install dependencies. Run ${chalk.cyan(`cd ${projectName} && ${installCmd}`)} manually.`);
+    }
+    // Init git
+    try {
+        execSync("git init", { cwd: targetDir, stdio: "pipe" });
+        execSync("git add -A", { cwd: targetDir, stdio: "pipe" });
+        execSync('git commit -m "Initial commit from create-varity-app"', {
+            cwd: targetDir,
+            stdio: "pipe",
+        });
+    }
+    catch {
+        // git not available or init failed — not critical
+    }
+    // Success output
+    console.log();
+    console.log(chalk.green("  Success!") + ` Created ${chalk.bold(projectName)}`);
+    console.log();
+    console.log("  Next steps:");
+    console.log();
+    console.log(chalk.cyan(`    cd ${projectName}`));
+    console.log(chalk.cyan(`    ${packageManager === "npm" ? "npm run" : packageManager} dev`) + "        Start development server");
+    console.log(chalk.cyan(`    ${packageManager === "npm" ? "npm run" : packageManager} build`) + "      Build for production");
+    console.log();
+    console.log("  Deploy when ready:");
+    console.log();
+    console.log(chalk.cyan("    pip install varitykit"));
+    console.log(chalk.cyan("    varitykit app deploy"));
+    console.log();
+    console.log(`  Docs:  ${chalk.underline("https://docs.varity.so")}`);
+    console.log(`  Help:  ${chalk.underline("https://discord.gg/varity")}`);
+    console.log();
+}

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import prompts from "prompts";
+import { createApp } from "./create.js";
+import { validateProjectName, detectPackageManager } from "./utils.js";
+import fs from "fs";
+const packageJson = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+const program = new Command();
+program
+    .name("create-varity-app")
+    .description("Create a production-ready app with auth, database, and payments built in")
+    .version(packageJson.version)
+    .argument("[app-name]", "Name of the app to create")
+    .action(async (appName) => {
+    console.log();
+    console.log(chalk.bold("  create-varity-app"));
+    console.log();
+    let projectName = appName;
+    // Prompt for name if not provided
+    if (!projectName) {
+        const response = await prompts({
+            type: "text",
+            name: "name",
+            message: "What is your app named?",
+            initial: "my-app",
+            validate: (value) => {
+                const result = validateProjectName(value);
+                return result.valid ? true : result.error || "Invalid name";
+            },
+        }, { onCancel: () => process.exit(0) });
+        projectName = response.name;
+        if (!projectName)
+            process.exit(0);
+    }
+    // Validate the name
+    const validation = validateProjectName(projectName);
+    if (!validation.valid) {
+        console.error(chalk.red(`  Invalid project name: ${validation.error}`));
+        process.exit(1);
+    }
+    const packageManager = detectPackageManager();
+    await createApp(projectName, packageManager);
+});
+program.parse();

package/dist/utils.js

@@ -0,0 +1,29 @@
+import validatePkgName from "validate-npm-package-name";
+export function validateProjectName(name) {
+    const validation = validatePkgName(name);
+    if (!validation.validForNewPackages) {
+        const errors = [
+            ...(validation.errors || []),
+            ...(validation.warnings || []),
+        ];
+        return { valid: false, error: errors.join(", ") };
+    }
+    if (name.length === 0) {
+        return { valid: false, error: "Project name cannot be empty" };
+    }
+    if (name.startsWith(".") || name.startsWith("_")) {
+        return { valid: false, error: "Project name cannot start with . or _" };
+    }
+    return { valid: true };
+}
+export function detectPackageManager() {
+    const agent = process.env.npm_config_user_agent || "";
+    if (agent.startsWith("pnpm"))
+        return "pnpm";
+    if (agent.startsWith("yarn"))
+        return "yarn";
+    return "npm";
+}
+export function getInstallCommand(pm) {
+    return pm === "yarn" ? "yarn" : `${pm} install`;
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "create-varity-app",
+  "version": "2.0.0-beta.1",
+  "description": "Create production-ready apps with auth, database, and payments built in",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/varity-labs/varity-sdk.git",
+    "directory": "packages/cli/create-varity-app"
+  },
+  "homepage": "https://docs.varity.so",
+  "bugs": {
+    "url": "https://github.com/varity-labs/varity-sdk/issues"
+  },
+  "keywords": [
+    "varity",
+    "create-app",
+    "saas",
+    "dashboard",
+    "nextjs",
+    "starter",
+    "template",
+    "react",
+    "deploy",
+    "auth",
+    "database",
+    "payments",
+    "developer-tools",
+    "fullstack"
+  ],
+  "bin": {
+    "create-varity-app": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "scripts": {
+    "prebuild": "node scripts/copy-template.mjs",
+    "build": "tsc",
+    "clean": "rm -rf dist template"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.1.0",
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^5.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "typescript": "^5.5.0"
+  }
+}

package/template/.env.example

@@ -0,0 +1,17 @@
+# Varity App Configuration
+#
+# ZERO CONFIG: Leave everything blank! Auth and database work immediately
+# using shared development credentials. No setup required.
+#
+# For production: `varitykit app deploy` injects all credentials automatically.
+# You never need to manually set these values.
+
+# Auth (optional — dev credentials used automatically when blank)
+NEXT_PUBLIC_PRIVY_APP_ID=
+NEXT_PUBLIC_THIRDWEB_CLIENT_ID=
+
+# Database (optional — dev database used automatically when blank)
+NEXT_PUBLIC_VARITY_APP_TOKEN=
+
+# App ID (generated by `varitykit app deploy`)
+NEXT_PUBLIC_VARITY_APP_ID=

package/template/KNOWN_ISSUES.md

@@ -0,0 +1,69 @@
+# Known Issues — SaaS Starter Template
+
+> **Last Updated:** February 14, 2026
+> **Template:** `saas-starter` (TaskFlow)
+> **Status:** All features functional, builds with 0 errors (8 routes + _not-found)
+
+---
+
+## What Works
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Landing Page | Working | 6 sections, scroll animations, social proof, testimonials, dashboard mockup |
+| Login | Working | Privy email/Google auth, zero-config with dev credentials, auto-redirect |
+| Dashboard | Working | KPI cards, getting started checklist, recent activity feed |
+| Projects CRUD | Working | Master-detail, nested tasks, CSV export, validation, optimistic updates |
+| Tasks CRUD | Working | Status cycling (click to advance), filtering, CSV export, cross-references projects |
+| Team CRUD | Working | Invite members, role management, email validation, role badges |
+| Settings | Working | 4 tabs (General, Security, Billing, Account), backend persistence via DB Proxy, skeleton loading |
+| Command Palette | Working | Cmd+K / Ctrl+K, searches pages and actions |
+| Toast Notifications | Working | Success/error/info with progress bar, exit animation, max 3 stack |
+| Protected Routes | Working | Automatic redirect for unauthenticated users |
+| Color Themes | Working | 4 built-in presets (Blue, Purple, Green, Orange) via CSS variables |
+| Static Export | Working | `output: 'export'` for IPFS deployment |
+| Mobile Nav | Working | Hamburger menu with responsive sidebar |
+| CSV Export | Working | One-click export for tasks and projects |
+| SEO | Working | OpenGraph, Twitter cards, robots.txt, sitemap template |
+
+## Known Issues
+
+### 1. Navigation Flash (UI-Kit Limitation)
+Brief "Initializing Dashboard" screen when navigating between dashboard pages. Caused by `PrivyReadyGate` in UI-Kit re-checking auth state on each route change. Resolves in <1 second. This is a UI-Kit issue, not template-side.
+
+### 2. DashboardLayout Mobile Support
+The `DashboardLayout` from `@varity-labs/ui-kit` does not include mobile navigation. The template provides its own responsive sidebar in `src/app/dashboard/layout.tsx` as a workaround. UI-Kit mobile improvements are planned post-MVP.
+
+### 3. Billing Section is Mock
+The Settings > Billing tab shows a mock UI (plan name, usage bars, payment method). Developers should wire their own billing provider (Stripe, etc.).
+
+### 4. Sessions Are Mock
+The Settings > Security tab shows active sessions with a "Revoke" button. Session data is client-side mock — real session management is handled by Privy (the auth provider).
+
+### 5. Password & Profile Managed by Auth Provider
+"Change password" and profile photo are managed by Privy (the auth provider). The Settings page shows informational dialogs explaining this.
+
+### 6. No Server-Side Rendering
+All pages are statically exported (`output: 'export'`). No server-side rendering, API routes, or middleware. Data fetching happens client-side via the SDK.
+
+### 7. Team Email Invites
+No SMTP integration — team members are added to the database only. No invitation email is sent. Developers should integrate their own email service.
+
+## Environment
+
+### Development (Zero Config)
+```bash
+npm install
+npm run dev
+```
+No `.env` file, API keys, or accounts needed. Shared development credentials are built in.
+
+### Production
+```bash
+varitykit app deploy
+```
+The CLI provisions a private database, injects production credentials, and deploys automatically.
+
+## Reporting Issues
+
+Please report issues at: https://github.com/varity-labs/varity-sdk/issues

package/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Varity Labs
+
+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.