create-partylayer-app 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * create-partylayer-app — scaffold a PartyLayer dApp.
+ *
+ *   npm create partylayer-app@latest
+ *   pnpm create partylayer-app
+ *   yarn create partylayer-app
+ *
+ * Flags (skip the matching prompt; pass all for a non-interactive run):
+ *   <dir>              target directory (positional)
+ *   --template, -t     template id (e.g. react-vite)
+ *   --pm               npm | pnpm | yarn
+ *   --no-install       skip dependency install
+ *   --no-git           skip git init
+ *   --help, -h         show this help
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as p from '@clack/prompts';
+import mri from 'mri';
+import pc from 'picocolors';
+import { runPrompts } from './prompts.js';
+import { scaffold } from './scaffold.js';
+import { isTemplateId, TEMPLATES } from './templates.js';
+const HELP = `${pc.bold('create-partylayer-app')} — scaffold a PartyLayer dApp
+
+${pc.bold('Usage')}
+  npm create partylayer-app@latest [dir] [options]
+
+${pc.bold('Options')}
+  -t, --template <id>   ${TEMPLATES.map((t) => t.id).join(', ')}
+      --pm <manager>    npm | pnpm | yarn
+      --no-install      skip dependency install
+      --no-git          skip git init
+  -h, --help            show this help
+`;
+async function main() {
+    const argv = mri(process.argv.slice(2), {
+        boolean: ['install', 'git', 'help'],
+        default: { install: true, git: true, help: false },
+        alias: { t: 'template', h: 'help' },
+    });
+    if (argv.help) {
+        console.log(HELP);
+        return;
+    }
+    p.intro(pc.bgYellow(pc.black(' create-partylayer-app ')));
+    const flagTemplate = typeof argv.template === 'string' ? argv.template : undefined;
+    if (flagTemplate && !isTemplateId(flagTemplate)) {
+        p.cancel(`Unknown template "${flagTemplate}". Available: ${TEMPLATES.map((t) => t.id).join(', ')}`);
+        process.exit(1);
+    }
+    const flagPm = typeof argv.pm === 'string' ? argv.pm : undefined;
+    if (flagPm && !['npm', 'pnpm', 'yarn'].includes(flagPm)) {
+        p.cancel(`Unknown package manager "${flagPm}". Use npm, pnpm, or yarn.`);
+        process.exit(1);
+    }
+    const opts = await runPrompts({
+        projectDir: typeof argv._[0] === 'string' ? argv._[0] : undefined,
+        template: flagTemplate,
+        pm: flagPm,
+        install: argv.install,
+        git: argv.git,
+    });
+    const targetDir = resolve(process.cwd(), opts.projectDir);
+    if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+        p.cancel(`Target directory "${opts.projectDir}" already exists and is not empty.`);
+        process.exit(1);
+    }
+    const templatesRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'templates');
+    const templateDir = join(templatesRoot, opts.template);
+    const s = p.spinner();
+    s.start(`Scaffolding ${pc.cyan(opts.projectName)} (${opts.template})`);
+    await scaffold(templateDir, targetDir, { PROJECT_NAME: opts.projectName });
+    s.stop(`Created ${pc.cyan(opts.projectDir)}`);
+    if (opts.git) {
+        const git = spawnSync('git', ['init', '-q'], { cwd: targetDir, stdio: 'ignore' });
+        if (git.status === 0) {
+            spawnSync('git', ['add', '-A'], { cwd: targetDir, stdio: 'ignore' });
+            spawnSync('git', ['commit', '-q', '-m', 'Initial commit from create-partylayer-app'], {
+                cwd: targetDir,
+                stdio: 'ignore',
+            });
+        }
+    }
+    if (opts.install) {
+        const inst = p.spinner();
+        inst.start(`Installing dependencies with ${opts.pm}`);
+        const res = spawnSync(opts.pm, ['install'], { cwd: targetDir, stdio: 'ignore' });
+        if (res.status === 0) {
+            inst.stop('Dependencies installed');
+        }
+        else {
+            inst.stop(pc.yellow(`Install skipped/failed — run "${opts.pm} install" yourself.`));
+        }
+    }
+    const steps = [
+        `cd ${opts.projectDir}`,
+        ...(opts.install ? [] : [`${opts.pm} install`]),
+        `${opts.pm} run dev`,
+    ];
+    p.note(steps.join('\n'), 'Next steps');
+    p.outro(`${pc.green('Done.')} Open the app and click Connect Wallet.`);
+}
+main().catch((err) => {
+    p.cancel(String(err instanceof Error ? err.message : err));
+    process.exit(1);
+});
+//# 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/dist/prompts.d.ts

@@ -0,0 +1,20 @@
+export type PackageManager = 'npm' | 'pnpm' | 'yarn';
+export interface ScaffoldOptions {
+    /** Target directory (relative to cwd), e.g. "my-app". */
+    projectDir: string;
+    /** Project name baked into package.json + app config (derived from dir). */
+    projectName: string;
+    template: string;
+    pm: PackageManager;
+    install: boolean;
+    git: boolean;
+}
+export interface InitialOptions {
+    projectDir?: string;
+    template?: string;
+    pm?: PackageManager;
+    install: boolean;
+    git: boolean;
+}
+export declare function runPrompts(initial: InitialOptions): Promise<ScaffoldOptions>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,cAAc,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAmBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA0ClF"}

package/dist/prompts.js

@@ -0,0 +1,65 @@
+/**
+ * Interactive prompt flow (project name → template → package manager → options).
+ * Every field is prompted ONLY if it wasn't supplied via a CLI flag, so passing
+ * all flags makes the CLI fully non-interactive (safe in CI / non-TTY).
+ */
+import * as p from '@clack/prompts';
+import { TEMPLATES } from './templates.js';
+const PM_VALUES = ['npm', 'pnpm', 'yarn'];
+/** A valid, install-safe directory/package name. */
+function sanitizeName(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^[-_.]+|[-_.]+$/g, '')
+        || 'partylayer-app';
+}
+function bail() {
+    p.cancel('Scaffolding cancelled.');
+    process.exit(0);
+}
+export async function runPrompts(initial) {
+    let projectDir = initial.projectDir;
+    if (!projectDir) {
+        const res = await p.text({
+            message: 'Project directory?',
+            placeholder: 'my-partylayer-app',
+            defaultValue: 'my-partylayer-app',
+        });
+        if (p.isCancel(res))
+            bail();
+        projectDir = res || 'my-partylayer-app';
+    }
+    let template = initial.template;
+    if (!template) {
+        const res = await p.select({
+            message: 'Which template?',
+            options: TEMPLATES.map((t) => ({ value: t.id, label: t.label, hint: t.hint })),
+            initialValue: TEMPLATES[0].id,
+        });
+        if (p.isCancel(res))
+            bail();
+        template = res;
+    }
+    let pm = initial.pm;
+    if (!pm) {
+        const res = await p.select({
+            message: 'Package manager?',
+            options: PM_VALUES.map((v) => ({ value: v, label: v })),
+            initialValue: 'npm',
+        });
+        if (p.isCancel(res))
+            bail();
+        pm = res;
+    }
+    return {
+        projectDir,
+        projectName: sanitizeName(projectDir.split('/').pop() || projectDir),
+        template,
+        pm,
+        install: initial.install,
+        git: initial.git,
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAuB3C,MAAM,SAAS,GAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5D,oDAAoD;AACpD,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;WAC7B,gBAAgB,CAAC;AACxB,CAAC;AAED,SAAS,IAAI;IACX,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB;IACtD,IAAI,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,oBAAoB;YAC7B,WAAW,EAAE,mBAAmB;YAChC,YAAY,EAAE,mBAAmB;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,EAAE,CAAC;QAC5B,UAAU,GAAI,GAAc,IAAI,mBAAmB,CAAC;IACtD,CAAC;IAED,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9E,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,EAAE,CAAC;QAC5B,QAAQ,GAAG,GAAa,CAAC;IAC3B,CAAC;IAED,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACvD,YAAY,EAAE,KAAuB;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,EAAE,CAAC;QAC5B,EAAE,GAAG,GAAqB,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,UAAU;QACV,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,CAAC;QACpE,QAAQ;QACR,EAAE;QACF,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,2 @@
+export declare function scaffold(templateDir: string, targetDir: string, vars: Record<string, string>): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AA2BA,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/scaffold.js

@@ -0,0 +1,42 @@
+/**
+ * Copy a template directory into the target, applying:
+ *  - file renames: `_package.json` → `package.json`, and any other `_x` → `.x`
+ *    (so a published `.gitignore` isn't rewritten to `.npmignore` by npm, and
+ *    `templates/<id>/_package.json` is NOT picked up by the monorepo's
+ *    `packages/*` workspace glob);
+ *  - placeholder substitution: `{{VAR}}` → vars[VAR].
+ */
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const RENAME = {
+    '_package.json': 'package.json',
+};
+function targetName(name) {
+    if (RENAME[name])
+        return RENAME[name];
+    if (name.startsWith('_'))
+        return '.' + name.slice(1);
+    return name;
+}
+function substitute(content, vars) {
+    return content.replace(/\{\{(\w+)\}\}/g, (_match, key) => Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : `{{${key}}}`);
+}
+export async function scaffold(templateDir, targetDir, vars) {
+    await copyDir(templateDir, targetDir, vars);
+}
+async function copyDir(src, dest, vars) {
+    await mkdir(dest, { recursive: true });
+    const entries = await readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const from = join(src, entry.name);
+        const to = join(dest, targetName(entry.name));
+        if (entry.isDirectory()) {
+            await copyDir(from, to, vars);
+        }
+        else {
+            const content = await readFile(from, 'utf8');
+            await writeFile(to, substitute(content, vars));
+        }
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAA2B;IACrC,eAAe,EAAE,cAAc;CAChC,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAA4B;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB,EACnB,SAAiB,EACjB,IAA4B;IAE5B,MAAM,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,GAAW,EACX,IAAY,EACZ,IAA4B;IAE5B,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/templates.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template registry. Each entry maps to a directory under `templates/<id>/`.
+ * New templates (next-ssr, vue-nuxt-pinia, vanilla) are added here as they land.
+ */
+export interface TemplateMeta {
+    /** Directory name under templates/ and the --template flag value. */
+    id: string;
+    /** Human label shown in the picker. */
+    label: string;
+    /** One-line hint shown next to the label. */
+    hint: string;
+}
+export declare const TEMPLATES: TemplateMeta[];
+export declare function isTemplateId(value: string): boolean;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,SAAS,EAAE,YAAY,EAWnC,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/templates.js

@@ -0,0 +1,16 @@
+export const TEMPLATES = [
+    {
+        id: 'react-vite',
+        label: 'React + Vite',
+        hint: 'React 18, Vite, zero-config PartyLayerKit',
+    },
+    {
+        id: 'next-ssr',
+        label: 'Next.js (SSR)',
+        hint: 'App Router, server-side session via cookieStorage',
+    },
+];
+export function isTemplateId(value) {
+    return TEMPLATES.some((t) => t.id === value);
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,2CAA2C;KAClD;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,mDAAmD;KAC1D;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-partylayer-app",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Scaffold a PartyLayer dApp (Canton wallet integration) in seconds.",
   "type": "module",
   "bin": {
@@ -45,6 +45,6 @@
   ],
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist *.tsbuildinfo"
   }
 }

package/templates/next-ssr/README.md

@@ -0,0 +1,28 @@
+# {{PROJECT_NAME}}
+
+A [PartyLayer](https://partylayer.xyz) dApp — Next.js App Router with **SSR session**.
+
+## Develop
+
+```bash
+npm run dev
+```
+
+## How SSR session works
+
+- **Server** ([lib/session.ts](lib/session.ts)) reads the session cookie via `next/headers` `cookies()` + `@partylayer/session`'s `createCookieStorage` → the connected party is rendered in the **initial HTML** (no disconnected→connected flash). `app/page.tsx` is a Server Component that gates on `getServerSession()`.
+- **Client** ([app/providers.tsx](app/providers.tsx)) wraps the app in `PartyLayerKit` with `sessionOptions={{ storage: createCookieStorage() }}` — `document.cookie` (synchronous), the **same** cookie the server reads.
+- `next/headers` is imported only in your app (`lib/session.ts`), never in `@partylayer/session` — the library stays framework-agnostic.
+
+Switch networks by changing `network` in `app/providers.tsx` and `appName` accordingly.
+
+## Build
+
+```bash
+npm run build && npm start
+```
+
+## Docs
+
+- [PartyLayer docs](https://partylayer.xyz/docs/introduction)
+- [@partylayer/session — createCookieStorage](https://www.npmjs.com/package/@partylayer/session)

package/templates/next-ssr/_gitignore

@@ -0,0 +1,10 @@
+node_modules
+.next
+out
+build
+*.local
+.DS_Store
+.env
+.env.*
+!.env.example
+next-env.d.ts

package/templates/next-ssr/_package.json

@@ -0,0 +1,26 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@partylayer/react": "^0.9.1",
+    "@partylayer/sdk": "^0.10.0",
+    "@partylayer/session": "^1.1.0",
+    "next": "^14.2.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.6.2"
+  }
+}

package/templates/next-ssr/app/globals.css

@@ -0,0 +1,42 @@
+:root {
+  color-scheme: light dark;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+  background: #0b0f1a;
+  color: rgba(255, 255, 255, 0.92);
+}
+
+.app {
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 16px;
+  padding: 24px;
+  text-align: center;
+}
+
+.app h1 {
+  font-size: 2.5rem;
+  margin: 0;
+}
+
+.subtitle {
+  margin: 0 0 8px;
+  color: rgba(255, 255, 255, 0.6);
+  max-width: 32rem;
+}
+
+.session code {
+  background: rgba(255, 255, 255, 0.08);
+  padding: 2px 8px;
+  border-radius: 6px;
+}

package/templates/next-ssr/app/layout.tsx

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react';
+import { Providers } from './providers';
+import './globals.css';
+
+export const metadata = {
+  title: '{{PROJECT_NAME}}',
+  description: 'A PartyLayer dApp on Canton (Next.js App Router + SSR session).',
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/templates/next-ssr/app/page.tsx

@@ -0,0 +1,33 @@
+import { getServerSession, truncateParty } from '@/lib/session';
+import { ConnectButton } from '@/components/ConnectButton';
+
+// Reading cookies() opts this route into dynamic (per-request) rendering — which
+// is exactly what SSR session needs: the server reads the session cookie on
+// every request and renders the connected state into the initial HTML.
+export default function Home() {
+  const session = getServerSession();
+  const party = session?.account?.partyId ?? null;
+
+  return (
+    <main className="app">
+      <h1>{{PROJECT_NAME}}</h1>
+      <p className="subtitle">A PartyLayer dApp on Canton — connect any verified wallet.</p>
+
+      {/* SERVER-RENDERED connected state (Option A: server owns the display). This
+          appears in the initial HTML from the cookie, before any client JS, so
+          there is no disconnected→connected flash. */}
+      {party ? (
+        <p className="session">
+          Connected as <code data-testid="server-party">{truncateParty(party)}</code>
+        </p>
+      ) : (
+        <p className="session" data-testid="server-cta">
+          Not connected — connect a wallet to continue.
+        </p>
+      )}
+
+      {/* Interactive client island — reconciles silently with the live provider. */}
+      <ConnectButton />
+    </main>
+  );
+}

package/templates/next-ssr/app/providers.tsx

@@ -0,0 +1,19 @@
+'use client';
+
+import { useMemo, type ReactNode } from 'react';
+import { PartyLayerKit } from '@partylayer/react';
+import { createCookieStorage } from '@partylayer/session';
+
+/**
+ * Client provider boundary. cookieStorage on the client uses document.cookie
+ * (synchronous → flash-free), the SAME cookie the server reads in lib/session.ts
+ * — so server HTML and client hydration agree.
+ */
+export function Providers({ children }: { children: ReactNode }) {
+  const storage = useMemo(() => createCookieStorage(), []);
+  return (
+    <PartyLayerKit network="devnet" appName="{{PROJECT_NAME}}" sessionOptions={{ storage }}>
+      {children}
+    </PartyLayerKit>
+  );
+}

package/templates/next-ssr/components/ConnectButton.tsx

@@ -0,0 +1,8 @@
+'use client';
+
+import { ConnectButton as PartyLayerConnectButton } from '@partylayer/react';
+
+/** Client island: the full connect flow (modal → connected state → disconnect). */
+export function ConnectButton() {
+  return <PartyLayerConnectButton />;
+}

package/templates/next-ssr/lib/session.ts

@@ -0,0 +1,41 @@
+import { cookies } from 'next/headers';
+import {
+  createCookieStorage,
+  decodeSessionEnvelope,
+  type CookieAdapter,
+  type PersistedSessionSnapshot,
+} from '@partylayer/session';
+
+// next/headers is imported HERE (the app), never inside @partylayer/session —
+// the library stays framework-agnostic. This adapter wraps Next's read-only
+// request cookies into the CookieAdapter shape createCookieStorage expects.
+function nextCookieAdapter(): CookieAdapter {
+  const jar = cookies();
+  return {
+    get: (name) => jar.get(name)?.value ?? null,
+    // Server Components can only READ cookies; writes happen client-side
+    // (document.cookie) or in a Route Handler / Server Action.
+    set: () => {},
+    remove: () => {},
+  };
+}
+
+/**
+ * Read the persisted session ON THE SERVER (for SSR). Returns the decoded
+ * snapshot (party, network, …) or null. This is what lets a Server Component
+ * render the connected state in the initial HTML — before any client JS.
+ */
+export function getServerSession(): PersistedSessionSnapshot | null {
+  const storage = createCookieStorage({ adapter: nextCookieAdapter() });
+  // Cookie reads are synchronous; the SessionStorage interface types getItem as
+  // string | null | Promise, so narrow to a string (null/absent → no session).
+  const raw = storage.getItem('pl_session');
+  if (typeof raw !== 'string') return null;
+  return decodeSessionEnvelope(raw);
+}
+
+/** Pure, server-safe party-id truncation (avoids importing a client module). */
+export function truncateParty(partyId: string): string {
+  if (partyId.length <= 16) return partyId;
+  return `${partyId.slice(0, 10)}…${partyId.slice(-4)}`;
+}

package/templates/next-ssr/next.config.mjs

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+export default nextConfig;

package/templates/next-ssr/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}