Skip to content

docs: refresh screenshots — v1-polish + 2FA features#15

Merged
valehdba merged 1 commit into
mainfrom
docs/refresh-screenshots
May 10, 2026
Merged

docs: refresh screenshots — v1-polish + 2FA features#15
valehdba merged 1 commit into
mainfrom
docs/refresh-screenshots

Conversation

@valehdba

Copy link
Copy Markdown
Owner

Summary

The static preview mockups + screenshots fell behind the live UI across several PRs (#10#13). Refreshing now to match what's actually shipping.

Refreshed (3 existing screenshots, 2 mockups)

Screenshot What's new in it
vault.png Per-row ✎ Edit icon next to ✕ Delete, ↥ Import button in the headrow, Settings · Export links in the sidebar user card
vault-add.png Switched the example to SSH protocol so the new SSH private-key (PEM) textarea shows; the password generator popover is open with a 24-char excellent-strength sample (length slider, char-set checkboxes, entropy meter all visible)

New (6 mockups, 5 screenshots — the 2FA flow)

Screenshot Captures
login-otp.png Phase-2 of two-step login — the "Two-factor verification" screen
settings-2fa-off.png Settings page with 2FA disabled (entry point)
settings-2fa-setup-qr.png Setup step 1 — modal with a real-generated QR + manual-entry fallback
settings-2fa-setup-recovery.png Setup step 3 — recovery-code list with Copy / Download actions
settings-2fa-on.png Settings page with 2FA enabled, showing the remaining-recovery-code count

The QR in the setup mockup is a real SVG generated from the same qrcode npm library the live app uses — scannable, not a placeholder.

Files

  • 5 new HTML mockups under docs/preview/
  • 5 new PNGs under docs/img/
  • 3 PNGs regenerated (vault, vault-add, vault-connect)
  • docs/preview/index.html — links the 5 new mockups
  • README.md — updated hero alt-text + new 2FA paragraph + screenshot
  • docs/USER_GUIDE.md — §5g (Two-factor authentication) reorganised to weave the 5 new screenshots inline with the setup walkthrough

Total: 18 files changed, 407 insertions, 34 deletions.

Reproducibility

The existing docs/preview/server.mjs + Chrome-headless one-liner under docs/USER_GUIDE.md "Reproducing the screenshots" cover all the new files via the glob loop — no separate process to maintain.

🤖 Generated with Claude Code

The static mockups under docs/preview/ had been promising for several
PRs to track the latest live DOM, but the screenshot regeneration kept
slipping. Refreshing now to cover everything that's landed since the
storage feature:

## Refreshed (existing files updated to match the live DOM)

- **vault.html / vault.png** — adds the per-row ✎ Edit icon next to
  the ✕ Delete, the ↥ Import button in the headrow next to + New
  credential, and Settings · Export links in the user card.
- **vault-add.html / vault-add.png** — switched the example credential
  from Postgres to SSH so the new SSH private-key (PEM) textarea
  shows; the password generator popover is open with a 24-char
  excellent-strength sample so the meter + checkboxes are visible.

## New mockups + screenshots

- **login-otp.png** — phase-2 of two-step login (the "Two-factor
  verification" screen).
- **settings-2fa-off.png** — Settings with 2FA disabled (the entry
  point for the setup flow).
- **settings-2fa-setup-qr.png** — Step 1 of setup, the modal showing
  a real-generated QR + manual-entry fallback.
- **settings-2fa-setup-recovery.png** — Step 3, the recovery-codes
  list with the warning copy and Copy / Download actions.
- **settings-2fa-on.png** — Settings with 2FA enabled, recovery-code
  count visible.

Reused the same self-contained pattern as the existing previews: each
HTML file `<link>`s the live `packages/web/src/styles.css` so the
rendering matches the React app byte-for-byte. The QR is a real SVG
generated from the `qrcode` npm lib (the same one the live app uses)
so it's a scannable code, not a placeholder.

## README

- Hero shot updated to the refreshed vault.png (now showing Edit /
  Import / Settings).
- New paragraph + screenshot for the 2FA feature.

## USER_GUIDE.md

- §5g (Two-factor authentication) reorganised to weave in five
  screenshots inline with the prose, walking the reader through the
  full setup flow + the post-setup login OTP step.
- Updated the alt text on vault-add.png to match the new SSH +
  password-generator content.

Preview index updated to link the new files. The reproducibility
one-liner in `docs/USER_GUIDE.md` already covers the new files via the
glob loop.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@valehdba valehdba merged commit e542b5d into main May 10, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant