deltadeck 0.2.0__tar.gz

deltadeck-0.2.0/.gitignore

@@ -0,0 +1,28 @@
+# recovery store: history, trash, audit log, remembered folders (contains your docs)
+.data/
+
+# python
+.venv/
+__pycache__/
+*.pyc
+.ruff_cache/
+.pytest_cache/
+
+# local uv cache (UV_CACHE_DIR=$PWD/.cache/uv)
+.cache/
+
+# misc
+.DS_Store
+.env
+.env.*
+
+# desktop app build outputs (desktop/build/icon.* are sources)
+desktop/node_modules/
+desktop/dist/
+desktop/release/
+desktop/build/server/
+desktop/build/pyenv/
+desktop/build/pyinstaller/
+
+# python package builds (uv build)
+/dist/

deltadeck-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dharmendra Sharma
+
+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.

deltadeck-0.2.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.5
+Name: deltadeck
+Version: 0.2.0
+Summary: Review what your AI changed, and hand it back. A local viewer for docs and code that highlights what changed.
+Project-URL: Homepage, https://github.com/dharmen8980/deltadeck
+Project-URL: Repository, https://github.com/dharmen8980/deltadeck
+Project-URL: Issues, https://github.com/dharmen8980/deltadeck/issues
+Project-URL: Documentation, https://github.com/dharmen8980/deltadeck/tree/main/docs
+Author: Dharmendra Sharma
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,code-review,diff,docs,fastapi,local,markdown,viewer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.13
+Requires-Dist: fastapi>=0.115
+Requires-Dist: mammoth>=1.8
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: playwright>=1.64.0
+Requires-Dist: python-multipart>=0.0.32
+Requires-Dist: sse-starlette>=2.1
+Requires-Dist: uvicorn>=0.30
+Requires-Dist: watchfiles>=0.24
+Description-Content-Type: text/markdown
+
+<img src="site/public/logo.svg" alt="" width="72" height="72">
+
+# DeltaDeck
+
+Every change, stacked for review. DeltaDeck is a local-only viewer for one
+folder of documents and code. Editing and file
+management are on by default; `--read-only` turns them off
+(see [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md)). The folder is given with `--root` /
+`DELTADECK_ROOT`, or chosen in the browser with the native folder dialog and
+switched at runtime from a list of recent folders (see [Choosing and switching
+folders](https://github.com/dharmen8980/deltadeck/blob/main/docs/configuration.md#choosing-and-switching-folders)). A FastAPI server (`server/deltadeck/`)
+reads the folder and serves a static Next.js single-page app (`web/`, built to
+`web/out`) on `http://127.0.0.1:8765/`.
+
+## Install
+
+Desktop app, macOS and Linux x86_64 (downloads the latest release, checks it
+and installs it for you only):
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/dharmen8980/deltadeck/main/install.sh | bash
+```
+
+Browser version, macOS and Linux (Windows: use WSL; needs [uv](https://docs.astral.sh/uv/)):
+
+```sh
+uvx deltadeck --root .   # then open http://127.0.0.1:8765/
+```
+
+Building from source, pipx, direct downloads, updating and uninstalling:
+[Installing](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md).
+
+What it does:
+
+- A file tree with sorting by name or modified time, a filter box and a
+  "Recently changed" list.
+- Files git ignores are hidden like the viewer's own ignore list. **Show
+  hidden files** lists them dimmed; protected files like `.env` open read-only
+  after a confirmation. See [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md#hidden-files).
+- Viewers for each file type:
+  - Markdown: GFM, a table of contents, mermaid diagrams, shiki highlighting,
+    and relative links and images that resolve inside the folder.
+  - `.mmd` diagrams and source code with line anchors.
+  - A code outline next to source code (Python, JavaScript / TypeScript,
+    CSS / SCSS / LESS, HTML, Java, C#, shell): classes, functions, methods,
+    selectors, headings and so on, with jump-to-line; see [Code
+    outline](https://github.com/dharmen8980/deltadeck/blob/main/docs/outline.md).
+  - JSON as a tree or as source.
+  - CSV and xlsx as sortable tables.
+  - Word `.docx`, view-only: converted on the server (mammoth) to sanitized
+    HTML in the markdown typography, with a table of contents, search,
+    change highlights and PDF export. Layout and styling are not kept; see
+    [Word documents](https://github.com/dharmen8980/deltadeck/blob/main/docs/docx.md).
+  - Images and PDFs.
+  - Large logs, loaded in chunks with real line numbers. The whole file is
+    never loaded.
+- Full-text search (SQLite FTS5, a contentless index on disk) with folder and type filters.
+  Match lines are ranked (whole phrase, then most distinct terms, then
+  whole-word hits). Choosing a markdown/mermaid match opens
+  `/?p=...&hl=<query>&hll=<match line>` and scrolls to the rendered block that
+  best matches that line.
+- Live updates through Server-Sent Events: new, modified, renamed and deleted
+  files and folders.
+- Changed since you last looked: files that changed since you last opened them
+  get a dot in the sidebar (and their folders too). Opening one shows what
+  changed, with highlighted markdown blocks or a line diff. A **What's new**
+  feed in the sidebar lists them all, newest first, with what changed in each.
+  The history is kept in the server's data dir, never in the folder; see
+  [Changes](https://github.com/dharmen8980/deltadeck/blob/main/docs/changes.md).
+- Read-only git awareness, when the folder is inside a git repository: what
+  changed since the last commit (same banner, highlights and diff), an
+  **Uncommitted** list in What's new with M/A/D/R/?? and +/- lines, and blame.
+  Nothing is ever written to the repository; see [Git](https://github.com/dharmen8980/deltadeck/blob/main/docs/git.md).
+- Find in the open file (Cmd/Ctrl+F, also in the desktop Edit menu): live
+  matches with match case, whole word and regex, across the whole text of large
+  files, every CSV cell and rendered markdown; see [Find in the file](https://github.com/dharmen8980/deltadeck/blob/main/docs/find.md).
+- Deep links (`/?p=<path>#<heading>` or `#L<line>`), light/dark themes and a
+  print stylesheet for markdown.
+- Resizable panels: drag (or use the arrow keys on) the edge of the file sidebar
+  and of the contents / outline panel; double-click resets. A **Reading width**
+  menu (Narrow, Medium, Wide, Full width; Full is the default) sets the markdown
+  and `.docx` column. Both are remembered; see [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md).
+- **Download PDF** for markdown, `.mmd` and `.docx` files: a properly paginated PDF
+  rendered by headless Google Chrome on the server (see [PDF export](https://github.com/dharmen8980/deltadeck/blob/main/docs/pdf-export.md)).
+- Editing (on by default, `--read-only` turns it off): a CodeMirror editor with live preview, file
+  management (new, rename, move, duplicate, upload, delete to Trash), version
+  history and undo (see [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md)).
+
+## Get it
+
+**Desktop app (macOS, Linux):** download the `.dmg`, `.AppImage` or `.deb` from
+[Releases](https://github.com/dharmen8980/deltadeck/releases). The app
+is unsigned for now: on macOS, a copy downloaded with a browser is blocked
+until you run `xattr -dr com.apple.quarantine /Applications/DeltaDeck.app`
+(see [docs/install.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md#download-from-releases)). Details in
+[docs/desktop.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/desktop.md); all the ways to install are in
+[docs/install.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md).
+
+**From source** (needs [uv](https://docs.astral.sh/uv/) and Node.js):
+
+```sh
+git clone https://github.com/dharmen8980/deltadeck.git
+cd deltadeck
+uv sync
+cd web && npm ci && npm run build && cd ..
+uv run deltadeck                  # http://127.0.0.1:8765/ (choose a folder in the browser)
+uv run deltadeck --root ~/notes   # or start on a given folder
+```
+
+## Documentation
+
+| Topic | |
+|---|---|
+| [Installing](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md) | One-line install, building from source, `uvx` / `pipx`, Releases downloads, updating, uninstalling, where data lives |
+| [Development](https://github.com/dharmen8980/deltadeck/blob/main/docs/development.md) | Prerequisites, install, build and run, dev mode with hot reload, tests |
+| [Configuration](https://github.com/dharmen8980/deltadeck/blob/main/docs/configuration.md) | Flags and environment variables; choosing and switching folders; `/api/roots` |
+| [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md) | Editing on by default, `--read-only`, history, trash, the recovery data dir, backups, limits, how writes are protected |
+| [Changes](https://github.com/dharmen8980/deltadeck/blob/main/docs/changes.md) | "Changed since you last looked": dots, the filter, the What's new feed, the banner, highlights, where the history is kept |
+| [Review basket](https://github.com/dharmen8980/deltadeck/blob/main/docs/review.md) | Picking highlighted changes, a note each, and copying them as one prompt for an AI agent |
+| [Git](https://github.com/dharmen8980/deltadeck/blob/main/docs/git.md) | Read-only git views: since last commit, the Uncommitted list, blame; which git is used; `/api/git/*` |
+| [Find in the file](https://github.com/dharmen8980/deltadeck/blob/main/docs/find.md) | Cmd/Ctrl+F: shortcuts, what each viewer searches, the editor's search panel, limits |
+| [Code outline](https://github.com/dharmen8980/deltadeck/blob/main/docs/outline.md) | The symbols panel for source code: languages, what is listed, how and when it is computed, bundle size |
+| [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md) | Resizing the sidebar and the contents / outline panel, keyboard, reading width, where it is saved |
+| [Word documents](https://github.com/dharmen8980/deltadeck/blob/main/docs/docx.md) | How `.docx` files are converted and shown, `/api/docx`, its limits |
+| [PDF export](https://github.com/dharmen8980/deltadeck/blob/main/docs/pdf-export.md) | How **Download PDF** renders markdown, mermaid and `.docx` |
+| [Desktop app](https://github.com/dharmen8980/deltadeck/blob/main/docs/desktop.md) | Installing, first launch, data and logs, building the app, desktop mode |
+| [Security model](https://github.com/dharmen8980/deltadeck/blob/main/docs/security.md) | What the server allows, refuses and why |
+| [Known limits](https://github.com/dharmen8980/deltadeck/blob/main/docs/known-limits.md) | Things that do not work (yet) |
+
+## License
+
+[MIT](https://github.com/dharmen8980/deltadeck/blob/main/LICENSE)

deltadeck-0.2.0/README.md

@@ -0,0 +1,132 @@
+<img src="site/public/logo.svg" alt="" width="72" height="72">
+
+# DeltaDeck
+
+Every change, stacked for review. DeltaDeck is a local-only viewer for one
+folder of documents and code. Editing and file
+management are on by default; `--read-only` turns them off
+(see [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md)). The folder is given with `--root` /
+`DELTADECK_ROOT`, or chosen in the browser with the native folder dialog and
+switched at runtime from a list of recent folders (see [Choosing and switching
+folders](https://github.com/dharmen8980/deltadeck/blob/main/docs/configuration.md#choosing-and-switching-folders)). A FastAPI server (`server/deltadeck/`)
+reads the folder and serves a static Next.js single-page app (`web/`, built to
+`web/out`) on `http://127.0.0.1:8765/`.
+
+## Install
+
+Desktop app, macOS and Linux x86_64 (downloads the latest release, checks it
+and installs it for you only):
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/dharmen8980/deltadeck/main/install.sh | bash
+```
+
+Browser version, macOS and Linux (Windows: use WSL; needs [uv](https://docs.astral.sh/uv/)):
+
+```sh
+uvx deltadeck --root .   # then open http://127.0.0.1:8765/
+```
+
+Building from source, pipx, direct downloads, updating and uninstalling:
+[Installing](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md).
+
+What it does:
+
+- A file tree with sorting by name or modified time, a filter box and a
+  "Recently changed" list.
+- Files git ignores are hidden like the viewer's own ignore list. **Show
+  hidden files** lists them dimmed; protected files like `.env` open read-only
+  after a confirmation. See [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md#hidden-files).
+- Viewers for each file type:
+  - Markdown: GFM, a table of contents, mermaid diagrams, shiki highlighting,
+    and relative links and images that resolve inside the folder.
+  - `.mmd` diagrams and source code with line anchors.
+  - A code outline next to source code (Python, JavaScript / TypeScript,
+    CSS / SCSS / LESS, HTML, Java, C#, shell): classes, functions, methods,
+    selectors, headings and so on, with jump-to-line; see [Code
+    outline](https://github.com/dharmen8980/deltadeck/blob/main/docs/outline.md).
+  - JSON as a tree or as source.
+  - CSV and xlsx as sortable tables.
+  - Word `.docx`, view-only: converted on the server (mammoth) to sanitized
+    HTML in the markdown typography, with a table of contents, search,
+    change highlights and PDF export. Layout and styling are not kept; see
+    [Word documents](https://github.com/dharmen8980/deltadeck/blob/main/docs/docx.md).
+  - Images and PDFs.
+  - Large logs, loaded in chunks with real line numbers. The whole file is
+    never loaded.
+- Full-text search (SQLite FTS5, a contentless index on disk) with folder and type filters.
+  Match lines are ranked (whole phrase, then most distinct terms, then
+  whole-word hits). Choosing a markdown/mermaid match opens
+  `/?p=...&hl=<query>&hll=<match line>` and scrolls to the rendered block that
+  best matches that line.
+- Live updates through Server-Sent Events: new, modified, renamed and deleted
+  files and folders.
+- Changed since you last looked: files that changed since you last opened them
+  get a dot in the sidebar (and their folders too). Opening one shows what
+  changed, with highlighted markdown blocks or a line diff. A **What's new**
+  feed in the sidebar lists them all, newest first, with what changed in each.
+  The history is kept in the server's data dir, never in the folder; see
+  [Changes](https://github.com/dharmen8980/deltadeck/blob/main/docs/changes.md).
+- Read-only git awareness, when the folder is inside a git repository: what
+  changed since the last commit (same banner, highlights and diff), an
+  **Uncommitted** list in What's new with M/A/D/R/?? and +/- lines, and blame.
+  Nothing is ever written to the repository; see [Git](https://github.com/dharmen8980/deltadeck/blob/main/docs/git.md).
+- Find in the open file (Cmd/Ctrl+F, also in the desktop Edit menu): live
+  matches with match case, whole word and regex, across the whole text of large
+  files, every CSV cell and rendered markdown; see [Find in the file](https://github.com/dharmen8980/deltadeck/blob/main/docs/find.md).
+- Deep links (`/?p=<path>#<heading>` or `#L<line>`), light/dark themes and a
+  print stylesheet for markdown.
+- Resizable panels: drag (or use the arrow keys on) the edge of the file sidebar
+  and of the contents / outline panel; double-click resets. A **Reading width**
+  menu (Narrow, Medium, Wide, Full width; Full is the default) sets the markdown
+  and `.docx` column. Both are remembered; see [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md).
+- **Download PDF** for markdown, `.mmd` and `.docx` files: a properly paginated PDF
+  rendered by headless Google Chrome on the server (see [PDF export](https://github.com/dharmen8980/deltadeck/blob/main/docs/pdf-export.md)).
+- Editing (on by default, `--read-only` turns it off): a CodeMirror editor with live preview, file
+  management (new, rename, move, duplicate, upload, delete to Trash), version
+  history and undo (see [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md)).
+
+## Get it
+
+**Desktop app (macOS, Linux):** download the `.dmg`, `.AppImage` or `.deb` from
+[Releases](https://github.com/dharmen8980/deltadeck/releases). The app
+is unsigned for now: on macOS, a copy downloaded with a browser is blocked
+until you run `xattr -dr com.apple.quarantine /Applications/DeltaDeck.app`
+(see [docs/install.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md#download-from-releases)). Details in
+[docs/desktop.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/desktop.md); all the ways to install are in
+[docs/install.md](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md).
+
+**From source** (needs [uv](https://docs.astral.sh/uv/) and Node.js):
+
+```sh
+git clone https://github.com/dharmen8980/deltadeck.git
+cd deltadeck
+uv sync
+cd web && npm ci && npm run build && cd ..
+uv run deltadeck                  # http://127.0.0.1:8765/ (choose a folder in the browser)
+uv run deltadeck --root ~/notes   # or start on a given folder
+```
+
+## Documentation
+
+| Topic | |
+|---|---|
+| [Installing](https://github.com/dharmen8980/deltadeck/blob/main/docs/install.md) | One-line install, building from source, `uvx` / `pipx`, Releases downloads, updating, uninstalling, where data lives |
+| [Development](https://github.com/dharmen8980/deltadeck/blob/main/docs/development.md) | Prerequisites, install, build and run, dev mode with hot reload, tests |
+| [Configuration](https://github.com/dharmen8980/deltadeck/blob/main/docs/configuration.md) | Flags and environment variables; choosing and switching folders; `/api/roots` |
+| [Editing](https://github.com/dharmen8980/deltadeck/blob/main/docs/editing.md) | Editing on by default, `--read-only`, history, trash, the recovery data dir, backups, limits, how writes are protected |
+| [Changes](https://github.com/dharmen8980/deltadeck/blob/main/docs/changes.md) | "Changed since you last looked": dots, the filter, the What's new feed, the banner, highlights, where the history is kept |
+| [Review basket](https://github.com/dharmen8980/deltadeck/blob/main/docs/review.md) | Picking highlighted changes, a note each, and copying them as one prompt for an AI agent |
+| [Git](https://github.com/dharmen8980/deltadeck/blob/main/docs/git.md) | Read-only git views: since last commit, the Uncommitted list, blame; which git is used; `/api/git/*` |
+| [Find in the file](https://github.com/dharmen8980/deltadeck/blob/main/docs/find.md) | Cmd/Ctrl+F: shortcuts, what each viewer searches, the editor's search panel, limits |
+| [Code outline](https://github.com/dharmen8980/deltadeck/blob/main/docs/outline.md) | The symbols panel for source code: languages, what is listed, how and when it is computed, bundle size |
+| [Layout](https://github.com/dharmen8980/deltadeck/blob/main/docs/layout.md) | Resizing the sidebar and the contents / outline panel, keyboard, reading width, where it is saved |
+| [Word documents](https://github.com/dharmen8980/deltadeck/blob/main/docs/docx.md) | How `.docx` files are converted and shown, `/api/docx`, its limits |
+| [PDF export](https://github.com/dharmen8980/deltadeck/blob/main/docs/pdf-export.md) | How **Download PDF** renders markdown, mermaid and `.docx` |
+| [Desktop app](https://github.com/dharmen8980/deltadeck/blob/main/docs/desktop.md) | Installing, first launch, data and logs, building the app, desktop mode |
+| [Security model](https://github.com/dharmen8980/deltadeck/blob/main/docs/security.md) | What the server allows, refuses and why |
+| [Known limits](https://github.com/dharmen8980/deltadeck/blob/main/docs/known-limits.md) | Things that do not work (yet) |
+
+## License
+
+[MIT](https://github.com/dharmen8980/deltadeck/blob/main/LICENSE)

deltadeck-0.2.0/hatch_build.py

@@ -0,0 +1,20 @@
+"""Wheel build hook: ship the built web UI (web/out) as deltadeck/ui.
+
+Editable installs (uv sync) skip this and read web/out in place."""
+
+import os
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+
+class UiBuildHook(BuildHookInterface):
+    PLUGIN_NAME = "custom"
+
+    def initialize(self, version, build_data):
+        if version == "editable":
+            return
+        out = os.path.join(self.root, "web", "out")
+        if not os.path.isfile(os.path.join(out, "index.html")):
+            raise RuntimeError(f"web UI not built ({out}/index.html missing): "
+                               "run 'npm ci && npm run build' in web/ before building the wheel")
+        build_data["force_include"][out] = "deltadeck/ui"

deltadeck-0.2.0/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "deltadeck"
+version = "0.2.0"
+description = "Review what your AI changed, and hand it back. A local viewer for docs and code that highlights what changed."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Dharmendra Sharma" }]
+keywords = ["markdown", "viewer", "docs", "diff", "code-review", "ai", "local", "fastapi"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: FastAPI",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Documentation",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Text Processing :: Markup :: Markdown",
+]
+dependencies = [
+    "fastapi>=0.115",
+    "uvicorn>=0.30",
+    "sse-starlette>=2.1",
+    "watchfiles>=0.24",
+    "openpyxl>=3.1",
+    "playwright>=1.64.0",
+    "python-multipart>=0.0.32",
+    "mammoth>=1.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/dharmen8980/deltadeck"
+Repository = "https://github.com/dharmen8980/deltadeck"
+Issues = "https://github.com/dharmen8980/deltadeck/issues"
+Documentation = "https://github.com/dharmen8980/deltadeck/tree/main/docs"
+
+[project.scripts]
+deltadeck = "deltadeck.cli:main"
+
+[dependency-groups]
+# Desktop build only (desktop/scripts/build-server.sh, uv run --group build --locked): exact pins,
+# hashes in uv.lock. Not installed by a plain `uv sync`.
+build = [
+    "pyinstaller==6.22.3",
+    "pyinstaller-hooks-contrib==2026.9",
+]
+dev = [
+    "pytest>=8",
+    "httpx>=0.27",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["server/deltadeck"]
+
+# The built web UI ships inside the wheel as deltadeck/ui (hatch_build.py; found by
+# deltadeck.config.find_ui_dir). Run `npm run build` in web/ first. Editable installs (uv sync)
+# use web/out in place.
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+# The sdist carries the server and the built UI, so a wheel can be built from it without Node.
+[tool.hatch.build.targets.sdist]
+include = ["/server/deltadeck", "/hatch_build.py", "/README.md", "/LICENSE", "/pyproject.toml"]
+
+[tool.hatch.build.targets.sdist.force-include]
+"web/out" = "web/out"
+
+[tool.pytest.ini_options]
+testpaths = ["server/tests"]
+addopts = "-p no:cacheprovider"
+filterwarnings = ["ignore::DeprecationWarning:fastapi.testclient", "ignore:Using `httpx`"]

deltadeck-0.2.0/server/deltadeck/__init__.py

@@ -0,0 +1,3 @@
+"""DeltaDeck viewer server (FastAPI backend)."""
+
+__version__ = "0.2.0"

deltadeck-0.2.0/server/deltadeck/__main__.py

@@ -0,0 +1,6 @@
+"""`python -m deltadeck` (also the PyInstaller entry point): same as `uv run deltadeck`."""
+
+from deltadeck.cli import main  # absolute: PyInstaller runs this file as a top-level script
+
+if __name__ == "__main__":
+    main()