Architecture
Architecture
This document describes the parts of the Printdeck system and how they connect. It explains how each deck, person, page and GitHub Action proves who it is. It shows why the passkey sign-in and the builds from GitHub are secure, and where their limits are.
Download the PDF (1.9 MB) Read it on the site
The document describes the system as of November 1, 2026, from the code at commit
c6215969. The short version is
ARCHITECTURE.md in the repository, and the page
The printdeck program.
The chapters
- 1Overviewthe decks, the printers, the slicers, the cloud and
pwf - 2Identity and trustdecks, the owner, members, share links, upload grants
- 3Passkey flowsowner enrollment, the invite workflow, sign-in, the session token
- 4Why it is secureeach control, where the code has it, and the limits
- 5The data of a printFDM and resin: live tile, share page, project record, notes, photos, the project page, the 3D view
- 6Builds from GitHubplans, plates, the slice runs, the approval, the profiles, forks, security
- 7The print queuethe queue of a deck, files from slicers, plates of builds, what a project sees
- 8The appsthe deck API for apps, the iPhone and Watch app, the sign-in in the app
- 9Updatesthe A/B image, staged updates, restarts during a print
- AAPI routeseach route of
/api/v1/and its auth
Sources. The facts come from the code at commit c6215969: cloud/api, cloud/deploy/template.yaml, cloud/cmd/pwf, cloud/cmd/pwf-web, cloud/deploy/web/assets, deck/internal/cloud, deck/internal/chitu, deck/internal/printer, deck/cmd/printdeck, deck/internal/system, os/ and profiles/. The builds from GitHub also come from docs/specs/github-builds.md and from the repository beetlebugorg/printdeck-action at commit 4f1e056. The passkey library is github.com/go-webauthn/webauthn v0.18.2.
Words. A deck is a Raspberry Pi 5 with a touch screen that runs Printdeck OS. The owner is the person who runs the service. A member is a friend that the owner invited to one or more projects. The API is the Go program on AWS Lambda. The bucket is the S3 bucket of the service. The Action is beetlebugorg/printdeck-action in a workflow of a project repository on GitHub.