jkunzandClaude Opus 5.5 3ae7299d2c feat(site): the landing page of Docbox at docbox.fin.cx
What Docbox does, how its executable runs (one file, one data
directory, sign-in through idp.global) and what a server needs, the
download of the newest release's Linux executables with sizes and
SHA-256 digests, and a setup guide from the download to the first
organization.

The server looks the release up at code.foss.global at most once per
10 minutes and keeps the last good answer when that fails. The
serve.zone declaration routes docbox.fin.cx to port 3000.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:45:59 +00:00

@fin.cx/landingpage-docbox

The landing page of Docbox at docbox.fin.cx: what Docbox does, how its executable runs, the download and a setup guide.

Issue Reporting and Security

For reporting bugs, issues, or security vulnerabilities, please visit community.foss.global/. This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a code.foss.global/ account to submit Pull Requests directly.

How it works

  • The page is one web component, <dbx-landing> (ts_web/), bundled into dist_serve/ with html/index.html. It loads no fonts, scripts or images from elsewhere and sets no cookies, and it follows the visitor's light or dark preference.
  • The download comes from code.foss.global. The server (ts/) asks https://code.foss.global/api/v1/repos/fin.cx/docbox/releases at most once per 10 minutes, offers the newest published release that carries docbox-linux-x64 or docbox-linux-arm64 with the digests from its SHA256SUMS.txt, and answers the page's getDocboxRelease typed request at /typedrequest. When code.foss.global fails it keeps the last good answer; until a release carries executables, the page links the releases page and the container route instead. A new Docbox release needs no change here.
  • The server is @api.global/typedserver's UtilityWebsiteServer on port 3000, with its health endpoint at /healthz.

Development

pnpm install
pnpm test         # builds the server and the production bundle, then runs test/
pnpm run watch    # rebuilds and restarts on changes, at http://localhost:3000
pnpm start        # the built server

Deployment

.smartconfig.json carries the serve.zone declaration (@git.zone/tsdeploy.deployment): the image from Dockerfile_##version## for linux/amd64 and linux/arm64, docbox.fin.cx routed to port 3000 with readiness at /healthz, no capabilities, no environment and built-in release evidence. The image builds from public packages only and runs as uid 10001. The gitzone release has a Git target only, with pnpm test and pnpm build as preflight.

This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the license.md file.

Please note: The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

Trademarks

This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.

Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.

Company Information

Task Venture Capital GmbH
Registered at District Court Bremen HRB 35230 HB, Germany

For any legal inquiries or further information, please contact us via email at hello@task.vc.

By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

S
Description
The landing page of Docbox at docbox.fin.cx
Readme
110 KiB
Languages
TypeScript 95.9%
HTML 3%
JavaScript 1.1%