create-feedbax 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Feedbax
+
+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,3 @@
+# create-feedbax
+
+Generate an owned, Notion-backed Feedbax portal with `npx create-feedbax@latest`.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { createInterface } from 'node:readline/promises';
+import { createProject, resolveCreateOptions, resolveInteractiveCreateOptions, } from './index.js';
+try {
+    const argv = process.argv.slice(2);
+    const interactive = process.stdin.isTTY && process.stdout.isTTY;
+    const options = interactive
+        ? await (async () => {
+            const terminal = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                return await resolveInteractiveCreateOptions(argv, async (question, defaultValue) => terminal.question(`${question} [${defaultValue}]: `));
+            }
+            finally {
+                terminal.close();
+            }
+        })()
+        : resolveCreateOptions(argv);
+    const result = await createProject(options);
+    process.stdout.write(`Created Feedbax in ${result.destination}\n\n${result.nextSteps.join('\n')}\n`);
+}
+catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,YAAY,CAAA;AAEnB,IAAI,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAA;IAC/D,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAChB,MAAM,QAAQ,GAAG,eAAe,CAAC;gBAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,OAAO,MAAM,+BAA+B,CAC1C,IAAI,EACJ,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,CAC/B,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,KAAK,YAAY,KAAK,CAAC,CACvD,CAAA;YACH,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,KAAK,EAAE,CAAA;YAClB,CAAC;QACH,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,MAAM,CAAC,WAAW,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC/E,CAAA;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC9D,CAAA;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+type IdentityMode = 'anonymous' | 'email' | 'handoff';
+export type Deployment = 'cloudflare' | 'vercel' | 'node';
+export type PackageManager = 'npm' | 'pnpm';
+export interface CreateOptions {
+    readonly directory: string;
+    readonly identity: IdentityMode;
+    readonly deploy: Deployment;
+    readonly packageManager: PackageManager;
+    readonly preset: string;
+    readonly install: boolean;
+    readonly git: boolean;
+}
+export declare function resolveCreateOptions(argv: readonly string[]): CreateOptions;
+export type CreatePrompt = (question: string, defaultValue: string) => Promise<string>;
+export declare function resolveInteractiveCreateOptions(argv: readonly string[], prompt: CreatePrompt): Promise<CreateOptions>;
+export declare function createProject(options: CreateOptions): Promise<{
+    destination: string;
+    nextSteps: string[];
+}>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,KAAK,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAErD,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAA;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAC3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CACtB;AAoBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA6C3E;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpB,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAaxB;AAyCD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa;;;GA8DzD"}

package/dist/index.js

@@ -0,0 +1,173 @@
+import { cp, mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const valueFlags = new Set([
+    '--connector',
+    '--identity',
+    '--storage',
+    '--deploy',
+    '--preset',
+    '--package-manager',
+]);
+const booleanFlags = new Set(['--yes', '--no-install', '--no-git']);
+const allowedDeployments = new Set(['cloudflare', 'vercel', 'node']);
+const allowedPackageManagers = new Set(['npm', 'pnpm']);
+const identityMode = (mode) => {
+    if (mode === 'anonymous' || mode === 'email' || mode === 'handoff')
+        return mode;
+    throw new Error(`Identity mode "${mode}" is not supported in Feedbax 0.1.0.`);
+};
+export function resolveCreateOptions(argv) {
+    const values = new Map();
+    let directory;
+    for (let index = 0; index < argv.length; index += 1) {
+        const entry = argv[index];
+        if (valueFlags.has(entry)) {
+            const next = argv[index + 1];
+            if (!next || next.startsWith('-'))
+                throw new Error(`Option ${entry} requires a value.`);
+            values.set(entry, next);
+            index += 1;
+        }
+        else if (booleanFlags.has(entry))
+            continue;
+        else if (entry.startsWith('-'))
+            throw new Error(`Unknown option ${entry}.`);
+        else if (directory)
+            throw new Error(`Unexpected argument ${entry}.`);
+        else
+            directory = entry;
+    }
+    const value = (name) => values.get(name);
+    directory ??= 'my-feedback';
+    const connector = value('--connector') ?? 'notion';
+    const storage = value('--storage') ?? 'notion';
+    if (connector !== 'notion')
+        throw new Error(`Connector "${connector}" is not supported in Feedbax 0.1.0.`);
+    if (storage !== 'notion')
+        throw new Error(`Storage "${storage}" is deferred until after Feedbax 0.1.0.`);
+    const identity = identityMode(value('--identity') ?? 'email');
+    const deploy = (value('--deploy') ?? 'cloudflare');
+    if (!allowedDeployments.has(deploy))
+        throw new Error(`Deployment "${deploy}" is not supported.`);
+    const packageManager = (value('--package-manager') ??
+        'pnpm');
+    if (!allowedPackageManagers.has(packageManager))
+        throw new Error(`Package manager "${packageManager}" is not supported.`);
+    return {
+        directory,
+        identity,
+        deploy,
+        packageManager,
+        preset: value('--preset') ?? 'feedbax-default',
+        install: !argv.includes('--no-install'),
+        git: !argv.includes('--no-git'),
+    };
+}
+export async function resolveInteractiveCreateOptions(argv, prompt) {
+    if (argv.includes('--yes'))
+        return resolveCreateOptions(argv);
+    const prompted = [...argv];
+    const ask = async (flag, question, defaultValue) => {
+        if (argv.includes(flag))
+            return;
+        const answer = (await prompt(question, defaultValue)).trim() || defaultValue;
+        prompted.push(flag, answer);
+    };
+    await ask('--identity', 'Identity (anonymous, email, handoff)', 'email');
+    await ask('--deploy', 'Deployment (cloudflare, vercel, node)', 'cloudflare');
+    await ask('--package-manager', 'Package manager (pnpm, npm)', 'pnpm');
+    await ask('--preset', 'shadcn preset', 'feedbax-default');
+    return resolveCreateOptions(prompted);
+}
+async function assertEmpty(path) {
+    try {
+        if ((await readdir(path)).length > 0)
+            throw new Error(`Target directory is not empty: ${path}`);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+}
+async function replaceInTree(path, replacements) {
+    for (const entry of await readdir(path)) {
+        const target = join(path, entry);
+        if ((await stat(target)).isDirectory())
+            await replaceInTree(target, replacements);
+        else {
+            let content = await readFile(target, 'utf8');
+            for (const [token, replacement] of Object.entries(replacements))
+                content = content.replaceAll(token, replacement);
+            await writeFile(target, content);
+        }
+    }
+}
+const run = (command, args, cwd) => new Promise((resolvePromise, reject) => {
+    const child = spawn(command, args, { cwd, stdio: 'inherit', shell: false });
+    child.once('error', reject);
+    child.once('exit', (code) => code === 0
+        ? resolvePromise()
+        : reject(new Error(`${command} ${args.join(' ')} failed with ${code}.`)));
+});
+export async function createProject(options) {
+    const destination = resolve(options.directory);
+    await assertEmpty(destination);
+    await mkdir(dirname(destination), { recursive: true });
+    const packageDirectory = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(packageDirectory, '../template'),
+        resolve(packageDirectory, '../../../templates/default'),
+    ];
+    let template;
+    for (const candidate of candidates) {
+        try {
+            if ((await stat(candidate)).isDirectory()) {
+                template = candidate;
+                break;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!template)
+        throw new Error('The Feedbax project template is missing from this package.');
+    await cp(template, destination, { recursive: true });
+    await replaceInTree(destination, {
+        __GENERATOR_VERSION__: '0.1.0',
+        __IDENTITY__: options.identity,
+        __DEPLOYMENT__: options.deploy,
+        __PACKAGE_MANAGER__: options.packageManager,
+        __PACKAGE_MANAGER_SPEC__: options.packageManager === 'pnpm' ? 'pnpm@10.29.3' : 'npm@11.4.2',
+        __PRESET__: options.preset,
+        __NITRO_PRESET__: options.deploy === 'vercel'
+            ? 'vercel'
+            : options.deploy === 'cloudflare'
+                ? 'cloudflare-module'
+                : 'node-server',
+    });
+    try {
+        if (options.install) {
+            await run(options.packageManager, ['install'], destination);
+            await run(options.packageManager, ['run', 'type-check'], destination);
+        }
+        if (options.git)
+            await run('git', ['init'], destination);
+    }
+    catch (error) {
+        await writeFile(join(destination, '.feedbax-recovery'), `Generation stopped: ${error instanceof Error ? error.message : String(error)}\nRerun dependency installation and type checking after resolving the reported issue.\n`);
+        throw error;
+    }
+    return {
+        destination,
+        nextSteps: [
+            `cd ${options.directory}`,
+            'Copy .env.example to .env and configure Notion',
+            `${options.packageManager === 'pnpm' ? 'pnpm' : 'npx'} feedbax doctor`,
+            `${options.packageManager} run dev`,
+        ],
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "create-feedbax",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-feedbax": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "template",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "24.10.13"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test",
+    "test": "vitest run"
+  }
+}

package/template/.env.example

@@ -0,0 +1,4 @@
+# Server-only Notion integration token. Never expose this to browser code.
+NOTION_TOKEN=
+# At least 32 random bytes used to sign opaque visitor sessions.
+FEEDBAX_SESSION_SECRET=

package/template/README.md

@@ -0,0 +1,7 @@
+# Feedbax portal
+
+1. Copy `.env.example` to `.env` and configure the server-only values.
+2. Run `npx feedbax doctor`.
+3. Run `pnpm dev` (or `npm run dev`).
+
+Email identity is capture-only and does not verify ownership. Notion-backed interaction uniqueness is best effort.

package/template/apps/portal/components.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/styles.css",
+    "baseColor": "zinc",
+    "cssVariables": true
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/template/apps/portal/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@feedbax/portal",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev --port 3000",
+    "build": "vite build",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@feedbax/core": "^0.1.0",
+    "@feedbax/notion": "^0.1.0",
+    "@tanstack/react-router": "1.170.18",
+    "@tanstack/react-start": "1.168.20",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tailwind-merge": "3.5.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "4.1.18",
+    "@tanstack/router-plugin": "1.168.20",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "5.1.4",
+    "nitro": "3.0.260610-beta",
+    "tailwindcss": "4.1.18",
+    "vite": "7.3.6"
+  }
+}

package/template/apps/portal/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/template/apps/portal/src/routeTree.gen.ts

@@ -0,0 +1,59 @@
+/* eslint-disable */
+// @ts-nocheck
+// Generated by TanStack Router. It is refreshed by the Vite router plugin.
+
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as IndexRouteImport } from './routes/index'
+
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths: '/'
+  fileRoutesByTo: FileRoutesByTo
+  to: '/'
+  id: '__root__' | '/'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+}
+
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+
+const rootRouteChildren: RootRouteChildren = { IndexRoute }
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()
+
+import type { getRouter } from './router.tsx'
+declare module '@tanstack/react-start' {
+  interface Register {
+    ssr: true
+    router: Awaited<ReturnType<typeof getRouter>>
+  }
+}

package/template/apps/portal/src/router.tsx

@@ -0,0 +1,10 @@
+import { createRouter } from '@tanstack/react-router'
+import { routeTree } from './routeTree.gen'
+export function getRouter() {
+  return createRouter({ routeTree, scrollRestoration: true })
+}
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: ReturnType<typeof getRouter>
+  }
+}

package/template/apps/portal/src/routes/__root.tsx

@@ -0,0 +1,31 @@
+import {
+  createRootRoute,
+  HeadContent,
+  Outlet,
+  Scripts,
+} from '@tanstack/react-router'
+import styles from '../styles.css?url'
+export const Route = createRootRoute({
+  head: () => ({
+    meta: [
+      { charSet: 'utf-8' },
+      { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+      { title: 'Feedbax' },
+    ],
+    links: [{ rel: 'stylesheet', href: styles }],
+  }),
+  component: Root,
+})
+function Root() {
+  return (
+    <html lang="en">
+      <head>
+        <HeadContent />
+      </head>
+      <body>
+        <Outlet />
+        <Scripts />
+      </body>
+    </html>
+  )
+}

package/template/apps/portal/src/routes/index.tsx

@@ -0,0 +1,35 @@
+import { createFileRoute } from '@tanstack/react-router'
+export const Route = createFileRoute('/')({ component: Portal })
+function Portal() {
+  return (
+    <main>
+      <header>
+        <strong>Feedbax</strong>
+        <nav>
+          <a href="/">Feedback</a>
+          <a href="/roadmap">Roadmap</a>
+          <a href="/changelog">Changelog</a>
+        </nav>
+      </header>
+      <section>
+        <p className="eyebrow">PUBLIC FEEDBACK</p>
+        <h1>What should we build next?</h1>
+        <p>
+          Browse ideas, vote on priorities, and share feedback with the team.
+        </p>
+        <button type="button">Submit feedback</button>
+      </section>
+      <section aria-label="Feedback">
+        <div className="toolbar">
+          <input aria-label="Search feedback" placeholder="Search feedback" />
+          <select aria-label="Status">
+            <option>All statuses</option>
+          </select>
+        </div>
+        <p className="empty">
+          Connect Notion and run <code>feedbax doctor</code> to load your board.
+        </p>
+      </section>
+    </main>
+  )
+}

package/template/apps/portal/src/styles.css

@@ -0,0 +1,91 @@
+@import 'tailwindcss';
+
+:root {
+  font-family: Inter, ui-sans-serif, system-ui, sans-serif;
+  color-scheme: light dark;
+  --background: #f6f5f1;
+  --foreground: #171815;
+  --primary: #315d42;
+  --border: #d7d7cf;
+  --radius: 0.65rem;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  background: var(--background);
+  color: var(--foreground);
+}
+main {
+  max-width: 72rem;
+  margin: auto;
+  padding: 0 2rem;
+}
+header {
+  height: 4.5rem;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  border-bottom: 1px solid var(--border);
+}
+nav {
+  display: flex;
+  gap: 1.5rem;
+}
+a {
+  color: inherit;
+  text-decoration: none;
+}
+section {
+  padding: 5rem 0;
+  border-bottom: 1px solid var(--border);
+}
+h1 {
+  max-width: 14ch;
+  font-size: clamp(2.8rem, 7vw, 6rem);
+  line-height: 0.95;
+  letter-spacing: -0.06em;
+  margin: 0.4rem 0 1.5rem;
+}
+.eyebrow {
+  font-size: 0.75rem;
+  letter-spacing: 0.18em;
+}
+.toolbar {
+  display: flex;
+  gap: 1rem;
+}
+input,
+select,
+button {
+  font: inherit;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.8rem 1rem;
+  background: transparent;
+}
+button {
+  background: var(--primary);
+  color: white;
+  border-color: var(--primary);
+}
+.empty {
+  padding: 4rem 0;
+  color: #666;
+}
+@media (max-width: 640px) {
+  main {
+    padding: 0 1.1rem;
+  }
+  nav {
+    gap: 0.75rem;
+    font-size: 0.85rem;
+  }
+  section {
+    padding: 3rem 0;
+  }
+  .toolbar {
+    flex-direction: column;
+  }
+}

package/template/apps/portal/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": { "@/*": ["./src/*"] },
+    "types": ["vite/client"]
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/template/apps/portal/vite.config.ts

@@ -0,0 +1,13 @@
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import react from '@vitejs/plugin-react'
+import { nitro } from 'nitro/vite'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vite'
+export default defineConfig({
+  plugins: [
+    tailwindcss(),
+    tanstackStart(),
+    nitro({ preset: '__NITRO_PRESET__' }),
+    react(),
+  ],
+})

package/template/feedbax.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from '@feedbax/core'
+export default defineConfig({
+  branding: {
+    name: 'My Feedback',
+    description: 'Help us decide what to build next',
+  },
+  features: { comments: true, roadmap: true, changelog: true },
+  statuses: [
+    { id: 'new', label: 'New' },
+    { id: 'planned', label: 'Planned' },
+    { id: 'shipped', label: 'Shipped', terminal: true },
+  ],
+})

package/template/feedbax.jsonc

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://feedbax.dev/schema/project.json",
+  "version": 1,
+  "generatorVersion": "__GENERATOR_VERSION__",
+  "connector": "notion",
+  "identity": "__IDENTITY__",
+  "interactionStore": "notion",
+  "deployment": "__DEPLOYMENT__",
+  "packageManager": "__PACKAGE_MANAGER__",
+  "shadcn": { "preset": "__PRESET__", "workspace": "apps/portal" },
+}

package/template/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "feedbax-project",
+  "private": true,
+  "packageManager": "__PACKAGE_MANAGER_SPEC__",
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "dev": "turbo run dev",
+    "build": "turbo run build",
+    "type-check": "turbo run type-check",
+    "doctor": "feedbax doctor"
+  },
+  "devDependencies": {
+    "feedbax": "^0.1.0",
+    "turbo": "2.10.4",
+    "typescript": "5.9.3"
+  }
+}

package/template/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - apps/*
+  - packages/*

package/template/turbo.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": { "dependsOn": ["^build"], "outputs": ["dist/**", ".output/**"] },
+    "type-check": { "dependsOn": ["^build"], "outputs": [] },
+    "dev": { "cache": false, "persistent": true }
+  }
+}