create-partylayer-app 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PartyLayer
+
+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,42 @@
+# create-partylayer-app
+
+Scaffold a [PartyLayer](https://partylayer.xyz) dApp — Canton wallet integration — in seconds.
+
+```bash
+npm create partylayer-app@latest
+# or
+pnpm create partylayer-app
+# or
+yarn create partylayer-app
+```
+
+Then follow the prompts (project directory → template → package manager).
+
+## Non-interactive
+
+Pass flags to skip the prompts (useful in CI):
+
+```bash
+npm create partylayer-app@latest my-app -- --template react-vite --pm npm
+```
+
+| Flag | Description |
+| --- | --- |
+| `<dir>` | Target directory (positional) |
+| `-t, --template <id>` | Template to use (`react-vite`) |
+| `--pm <manager>` | `npm` \| `pnpm` \| `yarn` |
+| `--no-install` | Skip dependency install |
+| `--no-git` | Skip git init |
+| `-h, --help` | Show help |
+
+## Templates
+
+| Template | Stack |
+| --- | --- |
+| `react-vite` | React 18 + Vite + zero-config `PartyLayerKit` |
+
+More templates (Next SSR, Vue/Nuxt/Pinia, Vanilla) are on the way.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-partylayer-app",
+  "version": "0.1.0",
+  "description": "Scaffold a PartyLayer dApp (Canton wallet integration) in seconds.",
+  "type": "module",
+  "bin": {
+    "create-partylayer-app": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "1.5.1",
+    "mri": "1.2.0",
+    "picocolors": "1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PartyLayer/PartyLayer.git",
+    "directory": "packages/create-partylayer-app"
+  },
+  "homepage": "https://github.com/PartyLayer/PartyLayer/tree/main/packages/create-partylayer-app",
+  "bugs": {
+    "url": "https://github.com/PartyLayer/PartyLayer/issues"
+  },
+  "license": "MIT",
+  "keywords": [
+    "partylayer",
+    "canton",
+    "wallet",
+    "create",
+    "scaffold",
+    "cli",
+    "dapp",
+    "starter"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  }
+}

package/templates/react-vite/README.md

@@ -0,0 +1,36 @@
+# {{PROJECT_NAME}}
+
+A [PartyLayer](https://partylayer.xyz) dApp — React + Vite, with Canton wallet integration.
+
+## Develop
+
+```bash
+npm run dev
+```
+
+Open the app and click **Connect Wallet** — the modal lists every verified Canton wallet from the registry.
+
+## How it's wired
+
+```tsx
+import { PartyLayerKit, ConnectButton } from '@partylayer/react';
+
+<PartyLayerKit network="devnet" appName="{{PROJECT_NAME}}">
+  <ConnectButton />
+</PartyLayerKit>
+```
+
+`<PartyLayerKit>` creates the client, registers all built-in wallet adapters, and provides session context. `<ConnectButton>` handles the full connect flow. Read the connected session with `useAccount()`.
+
+Switch networks by changing `network` to `"testnet"` or `"mainnet"` in `src/App.tsx`.
+
+## Build
+
+```bash
+npm run build && npm run preview
+```
+
+## Docs
+
+- [PartyLayer docs](https://partylayer.xyz/docs/introduction)
+- [@partylayer/react](https://www.npmjs.com/package/@partylayer/react)

package/templates/react-vite/_gitignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+dist-ssr
+*.local
+.DS_Store
+.env
+.env.*
+!.env.example

package/templates/react-vite/_package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@partylayer/react": "^0.9.1",
+    "@partylayer/sdk": "^0.10.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.1",
+    "typescript": "^5.6.2",
+    "vite": "^5.4.2"
+  }
+}

package/templates/react-vite/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{PROJECT_NAME}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-vite/src/App.css

@@ -0,0 +1,27 @@
+.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/react-vite/src/App.tsx

@@ -0,0 +1,32 @@
+import { PartyLayerKit, ConnectButton, useAccount, truncatePartyId } from '@partylayer/react';
+import './App.css';
+
+/**
+ * <PartyLayerKit> is the zero-config wrapper: pass `network` + `appName` and it
+ * creates the PartyLayer client, registers all built-in wallet adapters, and
+ * provides the session context. <ConnectButton> renders the full connect flow
+ * (wallet modal → connected state) on its own.
+ */
+export default function App() {
+  return (
+    <PartyLayerKit network="devnet" appName="{{PROJECT_NAME}}">
+      <main className="app">
+        <h1>{{PROJECT_NAME}}</h1>
+        <p className="subtitle">A PartyLayer dApp on Canton — connect any verified wallet.</p>
+        <ConnectButton />
+        <SessionPanel />
+      </main>
+    </PartyLayerKit>
+  );
+}
+
+/** Reads the active session and shows the connected party id. */
+function SessionPanel() {
+  const { address, isConnected } = useAccount();
+  if (!isConnected || !address) return null;
+  return (
+    <p className="session">
+      Connected as <code>{truncatePartyId(address)}</code>
+    </p>
+  );
+}

package/templates/react-vite/src/index.css

@@ -0,0 +1,14 @@
+:root {
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  color-scheme: light dark;
+  background: #0b0f1a;
+  color: rgba(255, 255, 255, 0.92);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+}

package/templates/react-vite/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import App from './App';
+import './index.css';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates/react-vite/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"]
+}

package/templates/react-vite/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react()],
+});