clivly 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clivly
+
+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,16 @@
+# clivly
+
+Scaffold [Clivly](https://clivly.com) — the CRM that lives inside your app.
+
+## Usage
+
+```bash
+npx clivly init          # detect your stack and print the scaffold plan
+npx clivly init --write  # write clivly.config.ts
+```
+
+`clivly init` detects your framework (Next.js, TanStack Start, SvelteKit, Remix, Nuxt) and ORM (Drizzle, Prisma, Kysely) from `package.json`, then reports the routes and schema fragment it will scaffold.
+
+## License
+
+MIT

package/dist/index.mjs

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+//#region src/detect.ts
+const FRAMEWORK_MARKERS = [
+	{
+		framework: "nextjs",
+		deps: ["next"]
+	},
+	{
+		framework: "tanstack-start",
+		deps: ["@tanstack/react-start"]
+	},
+	{
+		framework: "sveltekit",
+		deps: ["@sveltejs/kit"]
+	},
+	{
+		framework: "remix",
+		deps: ["@remix-run/react", "@remix-run/node"]
+	},
+	{
+		framework: "nuxt",
+		deps: ["nuxt"]
+	}
+];
+const ORM_MARKERS = [
+	{
+		orm: "drizzle",
+		deps: ["drizzle-orm"]
+	},
+	{
+		orm: "prisma",
+		deps: ["@prisma/client", "prisma"]
+	},
+	{
+		orm: "kysely",
+		deps: ["kysely"]
+	}
+];
+const FRAMEWORK_LABELS = {
+	nextjs: "Next.js",
+	"tanstack-start": "TanStack Start",
+	sveltekit: "SvelteKit",
+	remix: "Remix",
+	nuxt: "Nuxt",
+	unknown: "Unknown"
+};
+function detectFramework(deps) {
+	for (const { framework, deps: markers } of FRAMEWORK_MARKERS) if (markers.some((dep) => dep in deps)) return framework;
+	return "unknown";
+}
+function detectOrm(deps) {
+	for (const { orm, deps: markers } of ORM_MARKERS) if (markers.some((dep) => dep in deps)) return orm;
+	return "unknown";
+}
+//#endregion
+//#region src/scaffold.ts
+const FRAMEWORK_ROUTES = {
+	nextjs: [{
+		path: "app/crm/[[...slug]]/page.tsx",
+		description: "Mounts the Clivly SPA at /crm",
+		owned: true
+	}, {
+		path: "app/api/clivly/[...path]/route.ts",
+		description: "Clivly API handler",
+		owned: true
+	}],
+	"tanstack-start": [{
+		path: "src/routes/crm/$.tsx",
+		description: "Mounts the Clivly SPA at /crm",
+		owned: true
+	}, {
+		path: "src/routes/api/clivly/$.ts",
+		description: "Clivly API handler",
+		owned: true
+	}],
+	sveltekit: [{
+		path: "src/routes/crm/[...slug]/+page.svelte",
+		description: "Mounts the Clivly SPA at /crm",
+		owned: true
+	}, {
+		path: "src/routes/api/clivly/[...path]/+server.ts",
+		description: "Clivly API handler",
+		owned: true
+	}],
+	remix: [{
+		path: "app/routes/crm.$.tsx",
+		description: "Mounts the Clivly SPA at /crm",
+		owned: true
+	}, {
+		path: "app/routes/api.clivly.$.ts",
+		description: "Clivly API handler",
+		owned: true
+	}],
+	nuxt: [{
+		path: "pages/crm/[...slug].vue",
+		description: "Mounts the Clivly SPA at /crm",
+		owned: true
+	}, {
+		path: "server/api/clivly/[...path].ts",
+		description: "Clivly API handler",
+		owned: true
+	}],
+	unknown: []
+};
+const COMMON_FILES = [{
+	path: "drizzle/schema/clivly.ts",
+	description: "crm_* schema fragment — merge into your schema",
+	owned: false
+}, {
+	path: "clivly.config.ts",
+	description: "Your Clivly configuration",
+	owned: false
+}];
+function planScaffold(framework) {
+	return [...FRAMEWORK_ROUTES[framework] ?? [], ...COMMON_FILES];
+}
+function renderConfigTemplate(contactEntity) {
+	return `import { defineClivlyConfig } from "clivly";
+
+export default defineClivlyConfig({
+  // The host table Clivly treats as the contact entity.
+  contactEntity: "${contactEntity}",
+  contactFields: ["id", "email", "name", "created_at"],
+});
+`;
+}
+//#endregion
+//#region src/index.ts
+function readDeps(cwd) {
+	const pkgPath = join(cwd, "package.json");
+	if (!existsSync(pkgPath)) return {};
+	try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+		return {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+	} catch {
+		return {};
+	}
+}
+function runInit(cwd, write) {
+	const deps = readDeps(cwd);
+	if (Object.keys(deps).length === 0) {
+		process.stdout.write("No package.json found here. Run `clivly init` from your app root.\n");
+		return 1;
+	}
+	const framework = detectFramework(deps);
+	const orm = detectOrm(deps);
+	process.stdout.write("\nClivly init\n");
+	process.stdout.write(`  Framework: ${FRAMEWORK_LABELS[framework]}\n`);
+	process.stdout.write(`  ORM:       ${orm}\n\n`);
+	if (framework === "unknown") {
+		process.stdout.write("Could not detect a supported framework. Supported: Next.js, TanStack Start, SvelteKit, Remix, Nuxt.\n");
+		return 1;
+	}
+	const files = planScaffold(framework);
+	process.stdout.write("Will scaffold:\n");
+	for (const file of files) {
+		const tag = file.owned ? "generated" : "yours";
+		process.stdout.write(`  ${file.path}  (${tag}) — ${file.description}\n`);
+	}
+	process.stdout.write("\n");
+	if (write) {
+		const configPath = join(cwd, "clivly.config.ts");
+		if (existsSync(configPath)) process.stdout.write("clivly.config.ts already exists — skipped.\n");
+		else {
+			writeFileSync(configPath, renderConfigTemplate("users"), "utf8");
+			process.stdout.write("Created clivly.config.ts\n");
+		}
+	} else process.stdout.write("Dry run. Re-run with --write to scaffold.\n");
+	return 0;
+}
+function main(argv) {
+	const [command, ...rest] = argv;
+	const write = rest.includes("--write");
+	switch (command) {
+		case "init": return runInit(process.cwd(), write);
+		case void 0:
+		case "help":
+		case "--help":
+			process.stdout.write("clivly — embed a CRM in your app\n\nUsage:\n  clivly init [--write]   Detect your stack and scaffold Clivly\n");
+			return 0;
+		default:
+			process.stdout.write(`Unknown command: ${command}\n`);
+			return 1;
+	}
+}
+process.exitCode = main(process.argv.slice(2));
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "clivly",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",
+  "license": "MIT",
+  "bin": {
+    "clivly": "./dist/index.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsdown": "^0.21.9",
+    "typescript": "^6",
+    "@clivly.com/config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit"
+  },
+  "main": "./dist/index.mjs"
+}