create-dig-app 0.1.1

package/templates-ts/next-static/app/page.tsx

@@ -0,0 +1,18 @@
+export default function Home() {
+  return (
+    <main className="wrap">
+      <h1>__DISPLAY_NAME__</h1>
+      <p>
+        A Next.js static-export site on the <strong>DIG Network</strong> — served from a network no
+        host can read, change, or take down.
+      </p>
+      <p className="muted">
+        Build and preview for <strong>free</strong>. You only spend $DIG when you publish.
+      </p>
+      <pre>
+        <code>{`digstore dev      # preview, free
+digstore deploy   # publish a capsule ($DIG)`}</code>
+      </pre>
+    </main>
+  );
+}

package/templates-ts/next-static/dig.toml

@@ -0,0 +1,17 @@
+# dig.toml — the project manifest digstore (and the DIG SDK adapters) read.
+# Keys are kebab-case (snake_case also accepted). See:
+#   https://docs.dig.net/docs/digstore/cli/deploy-from-github-actions
+#
+# Everything here is LOCAL config. Scaffolding, building, and `digstore dev` cost nothing —
+# you only spend $DIG when you run `digstore deploy` to publish a capsule.
+
+# Next.js with `output: 'export'` emits static files to out/ — that is the content root.
+output-dir = "__OUTPUT_DIR__"
+
+# The command digstore runs to build before publishing (used by `digstore deploy` / CI).
+build-command = "__BUILD_COMMAND__"
+
+# Default remote a `digstore deploy` pushes to (resolves to your store after your first publish).
+remote = "origin"
+
+# network = "mainnet"

package/templates-ts/next-static/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/templates-ts/next-static/next.config.mjs

@@ -0,0 +1,11 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  // Static export — Next emits a folder of static files to out/, which digstore publishes as a
+  // capsule. A DIG capsule is a blind static host; there is no Next.js server at runtime.
+  output: "export",
+  // Relative-friendly asset paths so the build works under a *.on.dig.net subdomain and chia://.
+  images: { unoptimized: true },
+  trailingSlash: true,
+};
+
+export default nextConfig;

package/templates-ts/next-static/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "description": "__DISPLAY_NAME__ — a Next.js + TypeScript static-export site on the DIG Network.",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "next": "^14.2.15",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.16.11",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "typescript": "^5.6.3"
+  }
+}

package/templates-ts/next-static/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "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"]
+}

package/templates-ts/nft-drop/README.md

@@ -0,0 +1,74 @@
+# __DISPLAY_NAME__
+
+A wallet-connected **NFT drop** for the **DIG Network**, in **TypeScript** — a mint page wired to
+`@dignetwork/dig-sdk` (`ChiaProvider` for the wallet, `@dignetwork/dig-sdk/spend` for the canonical
+CHIP-0035 mint builder). The SDK ships its own types, so `ChiaProvider`/`ConnectOptions` are fully
+typed — no `@types/*` package needed for the SDK.
+
+Scaffolded with `npm create dig-app` (template: `nft-drop`, language: TypeScript).
+
+## Free until publish — and nothing was minted
+
+Scaffolding this template **did not mint anything, touch the chain, or spend funds.** Building and
+previewing the mint page are **free**. Two distinct costs come later, both explicit:
+
+- **Publishing the page** as a DIG capsule is one `digstore deploy` — **$DIG**.
+- **Minting the NFTs** is a separate, wallet-signed on-chain action a visitor triggers (it spends
+  the visitor's funds). The spend is **built with the SDK** and signed by the wallet — never
+  hand-rolled.
+
+## How minting is wired
+
+`src/mint.ts` connects a wallet with `ChiaProvider.connect({ mode: "auto" })` (prefers the injected
+DIG Browser wallet, falls back to WalletConnect → Sage) and shows the shape of a real mint: build
+coin spends with `@dignetwork/dig-sdk/spend`, then `provider.signCoinSpends(...)`. Wire your
+collection in `src/mint.ts` — see the spend builder and the "Build a dapp on Chia" tutorial:
+<https://github.com/DIG-Network/dig-sdk> · <https://docs.dig.net/docs/build-a-dapp>.
+
+The dev-shim wallet (in `digstore dev`) cannot sign — open the page in the **DIG Browser** (or
+connect a real wallet) to mint for real.
+
+## Connect to Sage in a normal browser (WalletConnect)
+
+Outside the DIG Browser there is no injected `window.chia`, so a visitor connects **Sage** (the main
+Chia wallet) over **WalletConnect**. This needs a free **project id**:
+
+1. Get one at **<https://cloud.reown.com>** (Reown, formerly WalletConnect Cloud).
+2. Copy `.env.example` to `.env` and set it:
+
+   ```sh
+   cp .env.example .env
+   # .env
+   VITE_WALLETCONNECT_PROJECT_ID=your_project_id_here
+   ```
+
+`@walletconnect/sign-client` is already a dependency, so once `VITE_WALLETCONNECT_PROJECT_ID` is set,
+**Connect wallet to mint** shows a pairing link/QR to approve in Sage and then displays the connected
+address. Leave it blank to support only the injected DIG Browser wallet. (Never commit `.env` — only
+the placeholder `.env.example` is tracked. The env is typed in `src/vite-env.d.ts`.)
+
+## Develop
+
+```sh
+npm install
+npm run dev            # Vite dev server at http://localhost:5173
+npm run typecheck      # tsc --noEmit (type-check without building)
+npm run build          # tsc --noEmit && vite build -> dist/ (your content root)
+digstore dev           # preview on the real chia:// read path + dev wallet shim — FREE, no spend
+```
+
+## Publish the mint page (this is the only step that spends $DIG)
+
+```sh
+digstore deploy        # build + publish a capsule ($DIG + a small XCH fee)
+```
+
+## Deploy from CI
+
+Wire up push-to-deploy with the GitHub Action:
+<https://docs.dig.net/docs/digstore/cli/deploy-from-github-actions>.
+
+## Config
+
+`dig.toml` is the project manifest digstore reads (output dir, build command, default remote).
+`tsconfig.json` configures TypeScript (strict mode, `bundler` resolution for Vite).

package/templates-ts/nft-drop/_env.example

@@ -0,0 +1,7 @@
+# WalletConnect Cloud / Reown project id — enables the WalletConnect → Sage fallback so this dapp
+# connects to Sage (the main Chia wallet) in a normal browser, not just the DIG Browser.
+#
+# Get a free project id at https://cloud.reown.com (formerly WalletConnect Cloud). Copy this file to
+# `.env` (or `.env.local`) and paste your id. Leave it blank to support ONLY the injected DIG Browser
+# wallet (window.chia) — the app still builds and runs; the WC fallback is just disabled.
+VITE_WALLETCONNECT_PROJECT_ID=

package/templates-ts/nft-drop/_gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+.dig/
+.DS_Store
+*.log
+
+# Local env (e.g. your WalletConnect projectId) — never commit secrets; .env.example is committed.
+.env
+.env.local
+.env.*.local

package/templates-ts/nft-drop/dig.toml

@@ -0,0 +1,18 @@
+# dig.toml — the project manifest digstore (and the DIG SDK adapters) read.
+# Keys are kebab-case (snake_case also accepted). See:
+#   https://docs.dig.net/docs/digstore/cli/deploy-from-github-actions
+#
+# Everything here is LOCAL config. Scaffolding, building, and `digstore dev` cost nothing —
+# you only spend $DIG when you run `digstore deploy` to publish the mint PAGE as a
+# capsule. (Minting the NFTs themselves is a separate, wallet-signed on-chain action — see README.)
+
+# Vite emits the production build to dist/ — the content root digstore publishes.
+output-dir = "__OUTPUT_DIR__"
+
+# The command digstore runs to build before publishing (used by `digstore deploy` / CI).
+build-command = "__BUILD_COMMAND__"
+
+# Default remote a `digstore deploy` pushes to (resolves to your store after your first publish).
+remote = "origin"
+
+# network = "mainnet"

package/templates-ts/nft-drop/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" />
+    <title>__DISPLAY_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates-ts/nft-drop/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "description": "__DISPLAY_NAME__ — a wallet-connected NFT drop on the DIG Network (TypeScript).",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@dignetwork/dig-sdk": "__SDK_VERSION__",
+    "@walletconnect/sign-client": "^2.11.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.11",
+    "vite-plugin-top-level-await": "^1.4.4",
+    "vite-plugin-wasm": "^3.3.0"
+  }
+}

package/templates-ts/nft-drop/src/App.tsx

@@ -0,0 +1,93 @@
+import { useState } from "react";
+import type { ChiaProvider } from "@dignetwork/dig-sdk";
+import { connectWallet, mint } from "./mint.ts";
+
+export default function App() {
+  const [provider, setProvider] = useState<ChiaProvider | null>(null);
+  const [address, setAddress] = useState<string>("");
+  const [status, setStatus] = useState<string>("");
+  const [error, setError] = useState<string>("");
+  // The WalletConnect pairing URI (only set during the WC → Sage fallback) — show it as a copy-link
+  // / QR / deep link so the visitor can approve in Sage.
+  const [wcUri, setWcUri] = useState<string>("");
+
+  async function onConnect() {
+    setError("");
+    setWcUri("");
+    try {
+      // Injected window.chia when present (DIG Browser / extension); otherwise WalletConnect → Sage.
+      // `onUri` fires only on the WC path, with the pairing URI to render.
+      const p = await connectWallet({ onUri: (uri) => setWcUri(uri) });
+      setProvider(p);
+      setAddress((await p.getAddress()) ?? "");
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setWcUri(""); // pairing complete (or failed) — drop the URI
+    }
+  }
+
+  async function onMint() {
+    if (!provider) return;
+    setError("");
+    setStatus("Building the mint spend…");
+    try {
+      // Minting spends real funds and is wallet-signed — never auto-invoked. Wire your collection in
+      // src/mint.ts. The dev-shim wallet (in `digstore dev`) cannot sign; use the DIG Browser.
+      await mint(provider);
+      setStatus("Minted!");
+    } catch (e) {
+      setStatus("");
+      setError(e instanceof Error ? e.message : String(e));
+    }
+  }
+
+  return (
+    <main className="wrap">
+      <h1>__DISPLAY_NAME__</h1>
+      <p>
+        An NFT drop on the <strong>DIG Network</strong> — mint NFTs whose media can live in a DIG
+        capsule, truly permanent on Chia.
+      </p>
+      <p className="muted">
+        Building and previewing this mint page are <strong>free</strong> — no mint, no chain, no spend
+        when you scaffold or run it. Publishing the page is one <code>digstore deploy</code> ($DIG).
+        Minting the NFTs is a separate, wallet-signed on-chain action a visitor triggers.
+      </p>
+
+      {address ? (
+        <div className="card">
+          <div className="row">
+            <span className="muted">Connected via</span>
+            <strong>{provider?.backend}</strong>
+          </div>
+          <div className="row">
+            <span className="muted">Address</span>
+            <code>{address}</code>
+          </div>
+          <button onClick={onMint}>Mint</button>
+          {status && <p className="muted">{status}</p>}
+        </div>
+      ) : (
+        <button onClick={onConnect}>Connect wallet to mint</button>
+      )}
+
+      {wcUri && (
+        <div className="card">
+          <p className="muted">
+            Scan or open this in <strong>Sage</strong> to connect (WalletConnect):
+          </p>
+          <code>{wcUri}</code>
+          <button onClick={() => navigator.clipboard?.writeText(wcUri)}>Copy pairing link</button>
+        </div>
+      )}
+
+      {error && <p className="error">{error}</p>}
+
+      <pre>
+        <code>{`digstore dev      # preview the mint page, free
+digstore deploy   # publish the page as a capsule ($DIG)`}</code>
+      </pre>
+    </main>
+  );
+}

package/templates-ts/nft-drop/src/main.tsx

@@ -0,0 +1,13 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import App from "./App.tsx";
+import "./styles.css";
+
+const rootEl = document.getElementById("root");
+if (!rootEl) throw new Error("Root element #root not found");
+
+createRoot(rootEl).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/templates-ts/nft-drop/src/mint.ts

@@ -0,0 +1,86 @@
+// NFT mint wiring via @dignetwork/dig-sdk (typed).
+//
+// IMPORTANT: scaffolding this template did NOT mint anything, touch the chain, or spend funds.
+// Minting is an explicit, wallet-signed on-chain action the visitor triggers below — it requires a
+// connected wallet and funds. The SDK is the canonical place to BUILD the spend; spends are never
+// hand-rolled. The wallet signs the coin spends the builder produces.
+//
+// @dignetwork/dig-sdk ships its own .d.ts types, so ChiaProvider, ConnectOptions, and
+// WalletConnectOptions are all fully typed — no `@types/*` package is needed for the SDK.
+
+import {
+  ChiaProvider,
+  type ConnectOptions,
+  type WalletConnectOptions,
+} from "@dignetwork/dig-sdk";
+
+// WalletConnect Cloud / Reown project id, read from the build-time env (see .env.example) and typed
+// via src/vite-env.d.ts. When set, it enables the WalletConnect → Sage fallback so visitors without
+// the injected DIG wallet can still connect Sage (the main Chia wallet) in a normal browser. Get a
+// free id at https://cloud.reown.com (formerly WalletConnect Cloud).
+const WALLETCONNECT_PROJECT_ID = import.meta.env.VITE_WALLETCONNECT_PROJECT_ID ?? "";
+
+/** Hooks for the connect flow (e.g. render the WalletConnect pairing URI as a QR / copy-link). */
+export interface ConnectHooks {
+  onUri?: (uri: string) => void;
+}
+
+/**
+ * Connect a wallet for the drop. `mode: "auto"` prefers the injected DIG Browser wallet
+ * (window.chia) and falls back to WalletConnect → Sage when a project id is configured (the SDK
+ * drives its `WalletConnectTransport` under the hood — we never hand-roll WC).
+ */
+export async function connectWallet(hooks: ConnectHooks = {}): Promise<ChiaProvider> {
+  // The typed WalletConnect options the SDK's WalletConnectTransport consumes (projectId + metadata
+  // + the pairing-URI hook + the Chia chain). Only built when a project id is configured.
+  const walletConnect: WalletConnectOptions | undefined = WALLETCONNECT_PROJECT_ID
+    ? {
+        projectId: WALLETCONNECT_PROJECT_ID,
+        metadata: {
+          name: "__DISPLAY_NAME__",
+          description: "An NFT drop built with create-dig-app",
+          url: typeof window !== "undefined" ? window.location.origin : "https://example.on.dig.net",
+          icons: [],
+        },
+        onUri: hooks.onUri, // render this URI as a QR / copy-link for the Sage fallback
+      }
+    : undefined;
+
+  const options: ConnectOptions = {
+    mode: "auto", // prefer injected window.chia; fall back to WalletConnect → Sage if configured
+    chain: "chia:mainnet", // CAIP-2 chain the SDK expects (Chia mainnet)
+    walletConnect,
+  };
+  return ChiaProvider.connect(options);
+}
+
+/**
+ * Build a mint spend with the canonical CHIP-0035 builder, then sign it with the wallet.
+ *
+ * This is the shape of a real mint: build the coin spends with `@dignetwork/dig-sdk/spend`, then
+ * hand them to `provider.signCoinSpends(...)`. Filling in the concrete mint builder + funding coins
+ * is left to you — see the chip35 spend builder + the "Build a dapp on Chia" tutorial:
+ *   https://github.com/DIG-Network/dig-sdk
+ *   https://docs.dig.net/docs/build-a-dapp
+ *
+ * It is intentionally NOT called automatically — minting spends real funds.
+ *
+ * @param provider A connected wallet (typed `ChiaProvider` from the SDK).
+ */
+export async function mint(provider: ChiaProvider): Promise<string> {
+  // The spend module is the canonical CHIP-0035 builder (re-exported chip35-dl-coin-wasm). Lazily
+  // imported so the read/connect path stays light until a visitor actually mints.
+  const spend = await import("@dignetwork/dig-sdk/spend");
+  spend.init();
+
+  // TODO: build your mint coin spends here with the wasm builder (e.g. from a prepared collection),
+  // then sign them with the wallet. Never hand-roll a spend bundle — always build it via the SDK.
+  const coinSpends: unknown[] = []; // <- produced by the spend builder for your collection/item
+  if (coinSpends.length === 0) {
+    throw new Error(
+      "No mint spend wired yet. Build your coin spends with @dignetwork/dig-sdk/spend, then sign them. " +
+        "See https://docs.dig.net/docs/build-a-dapp",
+    );
+  }
+  return provider.signCoinSpends(coinSpends);
+}

package/templates-ts/nft-drop/src/styles.css

@@ -0,0 +1,70 @@
+:root {
+  color-scheme: light dark;
+  --fg: #0f172a;
+  --muted: #64748b;
+  --bg: #f8fafc;
+  --error: #dc2626;
+
+  /* DIG brand accent — violet -> magenta (SYSTEM.md visual theme; matches dig.net/hub/status). */
+  --dig-violet: #5800D6;
+  --dig-magenta: #FF00DE;
+  --accent: var(--dig-violet);
+  --grad-brand: linear-gradient(115deg, #5800D6 0%, #FF00DE 100%);
+
+  /* DIG brand fonts — named first, system stack as the offline/no-fetch fallback so a scaffolded
+     capsule never depends on an external font host (keeps the site self-contained + offline-safe). */
+  --dig-font: "Space Grotesk", "Segoe UI", system-ui, -apple-system, Roboto, sans-serif;
+  --dig-mono: "Space Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+@media (prefers-color-scheme: dark) {
+  :root { --fg: #e2e8f0; --muted: #94a3b8; --bg: #0b1120; }
+}
+* { box-sizing: border-box; }
+body {
+  margin: 0;
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+  font: 16px/1.6 var(--dig-font);
+  color: var(--fg);
+  background: var(--bg);
+}
+.wrap { max-width: 42rem; padding: 2rem; }
+h1 {
+  font-size: 2.25rem;
+  margin: 0 0 0.5rem;
+  font-weight: 700;
+  background: var(--grad-brand);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}
+.muted { color: var(--muted); }
+.error { color: var(--error); }
+button {
+  font: inherit;
+  padding: 0.6rem 1.1rem;
+  border: 0;
+  border-radius: 0.5rem;
+  background: var(--grad-brand);
+  color: white;
+  cursor: pointer;
+}
+.card {
+  margin: 1rem 0;
+  padding: 1rem;
+  border-radius: 0.75rem;
+  background: rgba(127, 127, 127, 0.12);
+  display: grid;
+  gap: 0.5rem;
+}
+.row { display: flex; gap: 0.75rem; align-items: baseline; flex-wrap: wrap; }
+code { font-family: var(--dig-mono); word-break: break-all; }
+pre {
+  font-family: var(--dig-mono);
+  margin-top: 1.5rem;
+  background: rgba(127, 127, 127, 0.12);
+  padding: 1rem;
+  border-radius: 0.5rem;
+  overflow-x: auto;
+}

package/templates-ts/nft-drop/src/vite-env.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="vite/client" />
+
+// Type the WalletConnect projectId env so `import.meta.env.VITE_WALLETCONNECT_PROJECT_ID`
+// typechecks. Set its value in `.env` / `.env.local` (see .env.example).
+interface ImportMetaEnv {
+  readonly VITE_WALLETCONNECT_PROJECT_ID?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/templates-ts/nft-drop/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", "vite.config.ts"]
+}

package/templates-ts/nft-drop/vite.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import wasm from "vite-plugin-wasm";
+import topLevelAwait from "vite-plugin-top-level-await";
+
+// The CHIP-0035 spend builder (@dignetwork/dig-sdk/spend → chip35-dl-coin-wasm) is a WebAssembly
+// module loaded with top-level await, so we enable the wasm + top-level-await plugins. Relative base
+// so the built mint page works from any path on a *.on.dig.net subdomain (and chia://).
+export default defineConfig({
+  base: "./",
+  plugins: [react(), wasm(), topLevelAwait()],
+  build: { outDir: "dist" },
+});

package/templates-ts/vite-react/README.md

@@ -0,0 +1,44 @@
+# __DISPLAY_NAME__
+
+A React + **TypeScript** app (Vite) for the **DIG Network** — deployed to a network no host can
+read, change, or take down.
+
+Scaffolded with `npm create dig-app` (template: `vite-react`, language: TypeScript).
+
+## Free until publish
+
+Scaffolding, building, and previewing cost **nothing**. There is **no mint, no chain, and no spend**
+when you create or run this project — you only spend **$DIG** the moment you publish a
+capsule with `digstore deploy`. *Iterate for free, publish when it's ready.*
+
+## Develop
+
+```sh
+npm install
+npm run dev            # Vite dev server at http://localhost:5173
+npm run typecheck      # tsc --noEmit (type-check without building)
+npm run build          # tsc --noEmit && vite build -> dist/ (your content root)
+digstore dev           # preview on the real chia:// read path — FREE, no chain, no spend
+```
+
+`digstore dev` serves your built site through the genuine DIG read path (encrypt → compile → verify
+→ decrypt) with live reload and an injected `window.chia` dev shim, so what you see is exactly what
+visitors get.
+
+## Publish (this is the only step that spends $DIG)
+
+```sh
+digstore deploy        # build + publish a capsule ($DIG + a small XCH fee)
+```
+
+Your app goes live at its `*.on.dig.net` address. Re-run `digstore deploy` to ship an update.
+
+## Deploy from CI
+
+Wire up push-to-deploy with the GitHub Action:
+<https://docs.dig.net/docs/digstore/cli/deploy-from-github-actions>.
+
+## Config
+
+`dig.toml` is the project manifest digstore reads (output dir, build command, default remote).
+`tsconfig.json` configures TypeScript (strict mode, `bundler` resolution for Vite).

package/templates-ts/vite-react/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.dig/
+.DS_Store
+*.log

package/templates-ts/vite-react/dig.toml

@@ -0,0 +1,17 @@
+# dig.toml — the project manifest digstore (and the DIG SDK adapters) read.
+# Keys are kebab-case (snake_case also accepted). See:
+#   https://docs.dig.net/docs/digstore/cli/deploy-from-github-actions
+#
+# Everything here is LOCAL config. Scaffolding, building, and `digstore dev` cost nothing —
+# you only spend $DIG when you run `digstore deploy` to publish a capsule.
+
+# Vite emits the production build to dist/ — that is the content root digstore publishes.
+output-dir = "__OUTPUT_DIR__"
+
+# The command digstore runs to build before publishing (used by `digstore deploy` / CI).
+build-command = "__BUILD_COMMAND__"
+
+# Default remote a `digstore deploy` pushes to (resolves to your store after your first publish).
+remote = "origin"
+
+# network = "mainnet"

package/templates-ts/vite-react/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" />
+    <title>__DISPLAY_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>