anhedral 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+All Rights Reserved
+
+Copyright (c) 2026 Anhedral, Inc.
+
+   THE CONTENTS OF THIS PROJECT ARE PROPRIETARY AND CONFIDENTIAL.
+   UNAUTHORIZED COPYING, TRANSFERRING OR REPRODUCTION OF THE CONTENTS
+   OF THIS PROJECT, VIA ANY MEDIUM, IS STRICTLY PROHIBITED.
+
+   The receipt or possession of the source code and/or any parts thereof
+   does not convey or imply any right to use them for any purpose other
+   than the purpose for which they were provided to you.
+
+   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.
+
+   The above copyright notice and this permission notice shall be
+   included in all copies or substantial portions of the software.

package/README.md

@@ -0,0 +1,65 @@
+# anhedral
+
+Opinionated init CLI for product teams shipping with Next.js, Expo, Fastify, Drizzle, Neon, Clerk, Stripe, RevenueCat, and Cloudflare R2.
+
+## Requirements
+
+- Node.js 20+
+- `pnpm` available on your machine
+
+## Usage
+
+Run the CLI directly without installing it globally:
+
+```sh
+pnpm dlx anhedral init next
+pnpm dlx anhedral init next-fullstack
+pnpm dlx anhedral init expo-fullstack
+pnpm dlx anhedral init backend
+```
+
+```sh
+npx anhedral init next
+npx anhedral init next-fullstack
+npx anhedral init expo-fullstack
+npx anhedral init backend
+```
+
+Global install also works:
+
+```sh
+pnpm add -g anhedral
+anhedral init next
+```
+
+```sh
+npm install -g anhedral
+anhedral init next
+```
+
+## Stacks
+
+- `next`: Next.js App Router for the fastest web-only SaaS path.
+- `next-fullstack`: Next.js frontend plus Fastify backend for clearer service boundaries.
+- `expo-fullstack`: Expo app plus Fastify backend for mobile-first or multi-client products.
+- `backend`: Fastify-only API foundation for headless products and integrations.
+
+Each scaffold writes a `stack.json` file with the selected architecture and generated outputs.
+
+## Local Development
+
+```sh
+pnpm install
+pnpm build
+pnpm test:all
+```
+
+## Publishing
+
+This package is published once to the npm registry. `pnpm`, `npm`, `yarn`, and `bun` users all install that same published package.
+
+```sh
+pnpm build
+pnpm test:all
+npm publish
+```

package/anhedral.svg

@@ -0,0 +1,4 @@
+<svg width="4000" height="4000" viewBox="0 0 4000 4000" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0 200C0 89.5431 89.5431 0 200 0H3800C3910.46 0 4000 89.5431 4000 200V3800C4000 3910.46 3910.46 4000 3800 4000H200C89.5431 4000 0 3910.46 0 3800V200Z" fill="black"/>
+<path d="M2700.36 2965.84C2698.79 3089.66 2545.25 3146.21 2463.74 3052.98L1988.84 2509.79C2119.01 2206.09 2384.98 1972.11 2714.07 1888.26L2700.36 2965.84ZM2509.59 927.741C2599.33 861.325 2726.31 926.339 2724.89 1037.97L2714.28 1872.03C2679.28 1870.39 2643.87 1870.43 2608.15 1872.24C2239.16 1890.85 1922.8 2092.61 1742.64 2385.06L1027.5 2317.65C904.207 2306.03 860.316 2148.41 959.854 2074.73L2509.59 927.741Z" fill="white"/>
+</svg>

package/bin/anhedral.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/branding.d.ts

@@ -0,0 +1,3 @@
+export declare const ANHEDRAL_LOGO_FILE_NAME = "anhedral.svg";
+export declare const ANHEDRAL_LOGO_PUBLIC_PATH = "/anhedral.svg";
+export declare function writeAnhedralLogo(root: string): void;

package/dist/branding.js

@@ -0,0 +1,9 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { writeFile } from './util.js';
+export const ANHEDRAL_LOGO_FILE_NAME = 'anhedral.svg';
+export const ANHEDRAL_LOGO_PUBLIC_PATH = `/${ANHEDRAL_LOGO_FILE_NAME}`;
+const ANHEDRAL_LOGO_SVG = readFileSync(new URL('../anhedral.svg', import.meta.url), 'utf8');
+export function writeAnhedralLogo(root) {
+    writeFile(path.join(root, 'public', ANHEDRAL_LOGO_FILE_NAME), ANHEDRAL_LOGO_SVG);
+}

package/dist/commands.d.ts

@@ -0,0 +1,12 @@
+import type { InitMode } from './scaffold.js';
+import { type ToolchainSpec } from './toolchain.js';
+export type ScaffoldCommand = {
+    cmd: string;
+    stdinInput?: string;
+    skippable?: boolean;
+};
+export declare function getDefaultWebInitCommand(toolchain: ToolchainSpec, projectName: string): ScaffoldCommand;
+export declare function getDefaultWebDependencyCommands(): ScaffoldCommand[];
+export declare function getHeadlessInstallCommands(): ScaffoldCommand[];
+export declare function getBackendInstallCommands(): ScaffoldCommand[];
+export declare function getSkillCommands(mode: InitMode): string[];

package/dist/commands.js

@@ -0,0 +1,74 @@
+import { toolPackageRef } from './toolchain.js';
+const TYPESCRIPT_VERSION = '5.9.3';
+const NODE_TYPES_VERSION = '25.5.0';
+export function getDefaultWebInitCommand(toolchain, projectName) {
+    return {
+        cmd: [
+            'pnpm',
+            'dlx',
+            toolPackageRef('shadcn', toolchain.shadcn),
+            'init',
+            '-t',
+            'next',
+            '-n',
+            projectName,
+            '-d',
+            '-y',
+            '--css-variables',
+        ].join(' '),
+    };
+}
+export function getDefaultWebDependencyCommands() {
+    return [
+        {
+            cmd: 'pnpm add @clerk/nextjs @clerk/ui drizzle-orm @neondatabase/serverless stripe @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner',
+            skippable: true,
+        },
+        {
+            cmd: 'pnpm add -D babel-plugin-react-compiler drizzle-kit tsx dotenv',
+            skippable: true,
+        },
+    ];
+}
+export function getHeadlessInstallCommands() {
+    return [
+        {
+            cmd: 'pnpm add fastify @fastify/cors better-auth drizzle-orm @neondatabase/serverless @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner dotenv',
+            skippable: true,
+        },
+        {
+            cmd: `pnpm add -D typescript@${TYPESCRIPT_VERSION} tsx @types/node@${NODE_TYPES_VERSION} drizzle-kit`,
+            skippable: true,
+        },
+    ];
+}
+export function getBackendInstallCommands() {
+    return [
+        {
+            cmd: 'pnpm add fastify fastify-plugin @fastify/cors @fastify/env @fastify/compress @fastify/helmet @fastify/rate-limit @fastify/swagger @fastify/swagger-ui @fastify/multipart @clerk/fastify @neondatabase/serverless drizzle-orm @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner dotenv',
+        },
+        {
+            cmd: 'pnpm add -D typescript@5.9.3 tsx @types/node@25.5.0 drizzle-kit vitest @vitest/coverage-v8 @vercel/node eslint@9.39.4 @eslint/js@9.39.4 globals typescript-eslint pino-pretty',
+        },
+    ];
+}
+export function getSkillCommands(mode) {
+    switch (mode) {
+        case 'next':
+        case 'next-fullstack':
+            return [
+                'pnpm dlx skills add https://github.com/clerk/skills --skill clerk-custom-ui',
+                'pnpm dlx skills add https://github.com/stripe/ai --skill stripe-best-practices',
+            ];
+        case 'expo-fullstack':
+            return [
+                'pnpm dlx skills add https://github.com/clerk/skills --skill clerk-custom-ui',
+                'pnpm dlx skills add https://github.com/revenuecat/revenuecat-skill --skill revenuecat',
+                'pnpm dlx skills add https://github.com/stripe/ai --skill stripe-best-practices',
+            ];
+        case 'backend':
+            return [
+                'pnpm dlx skills add https://github.com/better-auth/skills --skill better-auth-best-practices',
+            ];
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env tsx
+export {};

package/dist/index.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env tsx
+import path from 'node:path';
+import { argv, env, exit } from 'node:process';
+import { STACK_IDS, scaffoldProject } from './scaffold.js';
+import { TOOLCHAIN_CHANNELS, resolveToolchainChannel } from './toolchain.js';
+const USAGE = `
+anhedral init <next|next-fullstack|expo-fullstack|backend> [--toolchain <latest|stable>]
+
+Commands:
+  anhedral init next
+    Next.js App Router, shadcn/ui, Tailwind CSS, TypeScript, Drizzle ORM, Neon Postgres, Clerk Auth, Stripe, Cloudflare R2
+
+  anhedral init next-fullstack
+    Next.js App Router, shadcn/ui, Tailwind CSS, TypeScript, Fastify, Drizzle ORM, Neon Postgres, Clerk Auth, Stripe, Cloudflare R2
+
+  anhedral init expo-fullstack
+    Expo, NativeWind/Tailwind CSS, TypeScript, Fastify, Drizzle ORM, Neon Postgres, Clerk Auth, RevenueCat + Stripe, Cloudflare R2
+
+  anhedral init backend
+    Fastify, TypeScript, Drizzle ORM, Neon Postgres, Clerk Auth or Better Auth, Stripe-ready integrations, Cloudflare R2
+`;
+function parseCli(args) {
+    const flags = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const token = args[index];
+        if (!token.startsWith('--')) {
+            if (flags.stack != null) {
+                throw new Error(`Unknown flag: ${token}`);
+            }
+            flags.stack = token;
+            continue;
+        }
+        if (token === '--toolchain') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new Error('Missing value for --toolchain');
+            }
+            flags.toolchain = value;
+            index += 1;
+            continue;
+        }
+        throw new Error(`Unknown flag: ${token}`);
+    }
+    if (!flags.stack) {
+        throw new Error(`Missing stack. Choose one of: ${STACK_IDS.join(', ')}`);
+    }
+    return flags;
+}
+function resolveMode(flags) {
+    if (!STACK_IDS.includes(flags.stack)) {
+        throw new Error(`Unknown stack: ${flags.stack}. Choose one of: ${STACK_IDS.join(', ')}`);
+    }
+    return flags.stack;
+}
+function deriveProjectName(cwd) {
+    const base = path.basename(cwd);
+    const sanitized = base
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return sanitized || 'anhedral-app';
+}
+function deriveDisplayName(cwd) {
+    const base = path.basename(cwd).trim();
+    return base || 'Anhedral App';
+}
+function buildOptions(flags) {
+    const cwd = process.cwd();
+    const mode = resolveMode(flags);
+    const projectName = deriveProjectName(cwd);
+    const displayName = deriveDisplayName(cwd);
+    if (flags.toolchain != null && !TOOLCHAIN_CHANNELS.includes(flags.toolchain)) {
+        throw new Error(`--toolchain must be one of: ${TOOLCHAIN_CHANNELS.join(', ')}`);
+    }
+    switch (mode) {
+        case 'next':
+            return {
+                mode,
+                projectName,
+                displayName,
+                auth: 'clerk',
+                payments: 'stripe',
+                db: 'neon',
+                orm: 'drizzle',
+                storage: 'r2',
+                api: null,
+                monorepo: false,
+                toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
+            };
+        case 'next-fullstack':
+            return {
+                mode,
+                projectName,
+                displayName,
+                auth: 'clerk',
+                payments: 'stripe',
+                db: 'neon',
+                orm: 'drizzle',
+                storage: 'r2',
+                api: 'fastify',
+                monorepo: true,
+                toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
+            };
+        case 'expo-fullstack':
+            return {
+                mode,
+                projectName,
+                displayName,
+                auth: 'clerk',
+                payments: 'revenuecat',
+                db: 'neon',
+                orm: 'drizzle',
+                storage: 'r2',
+                api: 'fastify',
+                monorepo: true,
+                toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
+            };
+        case 'backend':
+            return {
+                mode,
+                projectName,
+                displayName,
+                auth: 'betterauth',
+                payments: 'none',
+                db: 'neon',
+                orm: 'drizzle',
+                storage: 'r2',
+                api: 'fastify',
+                monorepo: false,
+                toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
+            };
+    }
+}
+async function main() {
+    const args = argv.slice(2);
+    const command = args[0];
+    if (!command || command === '--help' || command === '-h') {
+        console.log(USAGE);
+        exit(0);
+    }
+    if (command !== 'init') {
+        console.error(`Unknown command: ${command}`);
+        console.log(USAGE);
+        exit(1);
+    }
+    try {
+        const rawArgs = args.slice(1);
+        const options = buildOptions(parseCli(rawArgs));
+        await scaffoldProject(options);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        exit(1);
+    }
+}
+main();

package/dist/scaffold.d.ts

@@ -0,0 +1,25 @@
+import { type ToolchainChannel } from './toolchain.js';
+export declare const STACK_IDS: readonly ["next", "next-fullstack", "expo-fullstack", "backend"];
+export type InitMode = (typeof STACK_IDS)[number];
+export type AuthMode = 'clerk' | 'betterauth';
+export type PaymentsMode = 'none' | 'stripe' | 'revenuecat';
+export interface InitOptions {
+    mode: InitMode;
+    projectName: string;
+    displayName: string;
+    auth: AuthMode;
+    payments: PaymentsMode;
+    db: 'neon';
+    orm: 'drizzle';
+    storage: 'r2';
+    api: 'fastify' | null;
+    monorepo: boolean;
+    toolchainChannel: ToolchainChannel;
+}
+export interface ProjectOptions {
+    projectName: string;
+    displayName: string;
+    githubOrg: string | null;
+    frontendUrl?: string;
+}
+export declare function scaffoldProject(options: InitOptions): Promise<void>;