Skip to content

Document Row-Template 1.3.0 with official branding (do not merge before the v1.3.0 release) - #2

Merged
iitzSeriZdev merged 3 commits into
mainfrom
docs/row-template-1.3.0
Sep 27, 2026
Merged

iitzSeriZdev merged 3 commits into
mainfrom
docs/row-template-1.3.0

Conversation

@iitzSeriZdev

@iitzSeriZdev iitzSeriZdev commented Sep 27, 2026 •

Copy link
Copy Markdown
Owner

Brings the documentation site from Row-Template 1.2.0 to 1.3.0 (PasarGuard and Rebecca support, seventeen designs), with the official Row-Template branding.

Warning

Do not merge before Row-Template v1.3.0 is published. .github/workflows/deploy.yml deploys main to GitHub Pages, so merging this PR deploys the site. The v1.3.0 release does not exist yet, so:

  • the prepared https://github.com/iitzSeriZdev/Row-Template/releases/download/v1.3.0/… URLs (Manual installation, Release verification) return 404 until it is published;
  • the one-command installer (releases/latest/download/install.sh) still installs 1.2.0, which does not install on PasarGuard or Rebecca.

The site describes 1.3.0 as Upcoming, with no release date. Add the date to the changelog (English and Persian) when the release is published, then merge.

Commits

62e27fe — Document Row-Template 1.3.0

  • Every page, in English and Persian, now covers 3X-UI ≥ 3.6.0, PasarGuard 5.x and Rebecca 1.x (the binary install). Rebecca's 0.0.x Docker image is documented as refused. PasarGuard and Rebecca are no longer described as research targets.
  • RT_PANEL is required for a scripted fresh install on a server with more than one supported panel. RT_SMOKE_URL is documented.
  • Upgrading: one update from 1.1.0 or 1.2.0; there was no public 1.2.1.
  • Rollback: restores the page and the recorded version, not the manager and never the panel. Only the two newest backups are kept.
  • Templates: seventeen designs; Meter and Notebook are synced from Row-Template (catalogue, previews, live pages).
  • Error reference: the sync now reads every companion file the installer declares (the transaction engine and the panel adapters), and reads messages with nested quotes in full. All 455 messages (432 distinct) are documented in English and Persian, in 212 entries.
  • npm run check now works on Windows.

834dbbd — Official branding; 1.3.0 is upcoming; verified panel commands

  • Branding. Copied from the canonical logo files, which are unchanged. The originals' design-stage file names are not used anywhere public.

    Use Asset
    Navigation bar The symbol, 192 px. On the dark theme it sits on a white tile, because the symbol is dark on a transparent background.
    Landing hero The square logo (white on navy), 384 px lossless WebP with a PNG fallback.
    Favicon The app icon, 32 px, with the white canvas outside its rounded tile made transparent.
    apple-touch-icon The app icon, 180 px.
    OpenGraph / Twitter The square logo at full size (1254 px), summary card.
    README The square logo.

    The placeholder favicon.svg is removed. The only processing was lossless re-encodes (pixel-identical), downscaling, one lossless WebP, and the favicon's transparent corners. Nothing was upscaled, recoloured or stretched.

  • Header. The labelled search field now starts at 1024 px. Between 768 px and about 860 px the header used to overflow sideways; that predates this PR.

  • Release status. 1.3.0 is marked Upcoming in the changelog, the introduction and the landing pill, and 1.2.0 keeps Latest.

  • Panel commands. Checked against the panels' current official scripts:

    • pasarguard status and rebecca status exist:
      • PasarGuard: PasarGuard/scripts/pasarguard.sh, installed as /usr/local/bin/pasarguard;
      • Rebecca: scripts/rebecca/rebecca.sh and rebecca-binary.sh, installed as /usr/local/bin/rebecca.
    • PasarGuard's status is Docker-based, so each mention now also gives systemctl status pasarguard for a source install.
    • rebecca migrate-binary is not routed by the rebecca command in Rebecca's current scripts: migrate_docker_to_binary_command is defined, but dispatch_command has no case for it. The site no longer recommends it. It points to Rebecca's binary installer (rebecca-binary.sh), the install Row-Template is tested against, and explains the installer message that still names the command.

4b5e194 — Language switch: United States and Lion and Sun flags

  • The header's language switch shows the flag of the language it leads to:
    • on English pages, the Lion and Sun flag (to Persian);
    • on Persian pages, the United States flag (to English).
  • The language name stays available as the link's title and as screen-reader text.
  • public/flags/flag-fa-lion-and-sun.png is the Lion and Sun flag the owner supplied. The white canvas around it is made transparent and trimmed, and it is downscaled to 72 × 52 (shown at 22 px). It is not redrawn or recoloured.
  • public/flags/flag-en-us.svg is the United States flag in the same rounded frame.
  • A 1 px ring keeps the flags' white bands visible on the light theme.
  • Checked on English and Persian pages, in light and dark themes, at desktop width and at 375 px (no overflow). Both directions of the switch go to the right page.

Validation

  • npm run build: 87 pages.
  • npm run check: 455 installer messages (432 distinct) documented in 212 entries; 25 pages × 2 languages; links and anchors OK.
  • Browser checks on a local build:
    • Overflow: none on any of the 46 English and Persian pages at 375 px, nor on 20 of them re-checked at 800 px.
    • RTL: Persian pages are dir="rtl", with the brand on the right.
    • Sizing: the navbar mark is 28 px; the hero logo is 112 px on desktop and 88 px on phones.
    • Assets: every branding file returns 200 with the right type, and 134 resources across 9 pages load with no errors.
    • Views checked: English and Persian, light and dark, desktop and phone width.

🤖 Generated with Claude Code

iitzSeriZ and others added 3 commits September 27, 2026 11:11
Brings the site from Row-Template 1.2.0 to 1.3.0, written against the
1.3.0 installer source (Row-Template main at 5d7cade).

Panels: 3X-UI >= 3.6.0, PasarGuard 5.x and Rebecca 1.x (binary install)
are documented as supported everywhere; Rebecca's 0.0.x Docker image as
refused before anything changes. Activation, verify, uninstall, manager,
version output and troubleshooting cover each panel. PasarGuard and
Rebecca are no longer described as research targets.

Installation: RT_PANEL is required for a scripted fresh install on a
server with more than one supported panel; existing installs and updates
keep their panel. RT_SMOKE_URL is documented (the installer itself names
it). Upgrading: one update from 1.1.0 or 1.2.0; no public 1.2.1.
Rollback: restores the page and recorded version, not the manager and
never the panel; only the two newest backups are kept; 1.1.0 backups now
restore. A 1.3.0 limitations section is added to Compatibility.

Templates: seventeen designs, with Meter and Notebook synced from
Row-Template (catalogue, previews, live pages) and every ID listed.

Error reference: the sync now reads every companion the library
declares (transaction engine, panel adapters) and reads messages with
nested quotes whole, naming command substitutions as placeholders. All
455 messages (432 distinct) are documented in English and Persian in 212
entries; entries 1.3.0 made wrong were corrected, and new groups cover
panel choice, PasarGuard and Rebecca. The install directory is now a
placeholder, since it depends on the panel.

Also: check-site imports errors.ts through a file URL, so `npm run
check` works on Windows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Branding (copied from the canonical logo files, which are unchanged):
- public/branding/: the symbol (navigation bar, 192 px), the square
  logo (landing hero: 384 px lossless WebP with a 512 px PNG fallback;
  also the README), the social image (the square logo, full size,
  lossless re-encode) and the app icon (favicon 32 px with the white
  canvas outside its rounded tile made transparent; apple-touch-icon
  180 px). The placeholder favicon.svg is removed.
- Header: the official symbol replaces the placeholder icon; on the dark
  theme it sits on a white tile, since the symbol is dark on transparent.
- Landing: the square logo above the hero, its canvas corners clipped
  to the tile's own radius.
- Head: favicon, apple-touch-icon, og:image (+ type, size, alt) and a
  twitter summary card.
- README: the logo, and public/branding/ in the file table.
- Header layout: the labelled search field starts at 1024 px, where the
  menu button hides; between 768 and ~860 px the header used to overflow
  sideways (it did so before this change too).

1.3.0 is not released: the changelog marks it Upcoming with no date
(1.2.0 keeps Latest), the introduction and the landing pill say so, and
"shipped in 1.3.0" became "included in 1.3.0".

Panel commands, checked against the panels' current official scripts:
- `pasarguard status` and `rebecca status` exist (PasarGuard/scripts
  pasarguard.sh; Rebecca rebecca.sh and rebecca-binary.sh). PasarGuard's
  is Docker-based, so each mention now also gives `systemctl status
  pasarguard` for a source install.
- `rebecca migrate-binary` is not routed by the `rebecca` command in
  Rebecca's current scripts. The site no longer recommends it; it points
  to Rebecca's binary installer (rebecca-binary.sh), the install
  Row-Template is tested against, and explains the installer message
  that names the command.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The switch in the header shows the flag of the language it leads to: the
Lion and Sun flag on English pages, the United States flag on Persian
pages. The label stays available as the link's title and as screen-reader
text ("Language: فارسی" / "زبان: English").

- public/flags/flag-fa-lion-and-sun.png: the Lion and Sun flag supplied by
  the owner. The white canvas around it is made transparent and trimmed,
  and it is downscaled to 72 x 52 (22 px shown, up to 3x). It is not
  redrawn or recoloured.
- public/flags/flag-en-us.svg: the United States flag in the same rounded
  36 x 26 frame (13 stripes, 50 stars).
- A 1px border-colour ring keeps the flags' white bands visible on the
  light theme.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@graphify-labs graphify-labs Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Graphify reviewed this change.

Worth a look — the grounded gate found no coupling regressions or blocking issues, but 2 advisory finding(s) below merit a look before merge.


Graphify review — findings

Worth a look

  • Announce link href not scheme-validated (javascript: XSS) — public/live/meter/index.html · Escalate · high
    • agreed by 2 of 2 members but NOT verified (no proof, no reproducing execution) — consensus is not a verdict; needs human review
  • Search query not lowercased before compare, breaking case-insensitive filter — public/live/meter/index.html · Escalate · medium
    • agreed by 2 of 2 members but NOT verified (no proof, no reproducing execution) — consensus is not a verdict; needs human review
Analysis details — impact, health, verification

Impact & health

Graphify review

Impact — 543 functions depend on the 539 functions this change touches.

Health — this change adds coupling hotspots:

  • new: ../layouts/Base.astro — 3 callers, 14 callees
  • new: ../components/Landing.astro — 2 callers, 9 callees
  • new: ../components/TemplatePage.astro — 1 callers, 12 callees
  • new: ../components/Header.astro — 1 callers, 11 callees

Verification — 543 functions in the blast radius were not formally verified this run (proofs are advisory here).

Gate & verification

graphify gate

PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 543 function(s) in the blast radius were not formally verified this run

· 1 grounded finding(s) anchored inline below; 3 more finding(s) on lines outside this diff (see the check run).

Comment thread src/components/Header.astro Resolved
@iitzSeriZdev
iitzSeriZdev merged commit 9b93596 into main Sep 27, 2026
3 checks passed
@iitzSeriZdev iitzSeriZdev changed the title Document Row-Template 1.3.0 with official branding (do not merge before the v1.3.0 release) Document Row-Template 1.3.0, with official branding Sep 27, 2026
@iitzSeriZdev iitzSeriZdev changed the title Document Row-Template 1.3.0, with official branding Document Row-Template 1.3.0 with official branding (do not merge before the v1.3.0 release) Sep 27, 2026
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