Skip to content

docs: list BlueShell and Ghostty as apps on the site - #373

Merged
hanthor merged 2 commits into
mainfrom
flatpak/blueshell-ghostty-pages
Sep 6, 2026
Merged

docs: list BlueShell and Ghostty as apps on the site#373
hanthor merged 2 commits into
mainfrom
flatpak/blueshell-ghostty-pages

Conversation

@hanthor

@hanthor hanthor commented Sep 6, 2026

Copy link
Copy Markdown
Member

The TunaOS remote carries two terminals and neither was discoverable on the site. BlueShell (org.tunaos.BlueShell) has been live in the remote index since the repo moved into the org; stock upstream Ghostty (com.mitchellh.ghostty) lands with tuna-os/blueshell#83.

What's added

An app is listed in six places, not one — all six, for both apps:

  • src/data/projects.ts — the /projects card, the /<app> landing page, /install?app=<id>
  • src/pages/blueshell.tsx, src/pages/ghostty.tsxProjectLanding wrappers
  • docs/blueshell/index.md (rewritten), docs/ghostty/index.md (new)
  • sidebars.ts — entries under Apps
  • src/pages/flatpak.tsx and docs/flatpak/index.mdx — both install catalogs

docs/blueshell/ becomes hand-authored

scripts/sync-org-docs.mjs overwrites docs/<slug>/ from each repo's README unconditionally, so without the HAND_AUTHORED entry the next sync reverts this page. That sync is also why the tree carried CONTRIBUTING.md and TUNA_OS_PROMOTION.md — a contributor guide and an internal migration runbook, neither user-facing. Both deleted; they stay in the repo they came from.

ghostty is in HAND_AUTHORED too — no such repo exists in the org, and the page documents an app TunaOS only republishes, so the entry keeps it safe if one ever appears.

Merge order

Merge after flatpak install tuna-os com.mitchellh.ghostty actually works — the pages present both install commands as working. BlueShell's is already true today.

static/flatpak/expected-apps.json is deliberately not in this PR: check-flatpak-remote.py fails on an app listed there but absent from the index, so both entries go in a follow-up once Ghostty's index entry exists.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EMBRswEeeX2kzVSwpbxCoy

The TunaOS remote carries two terminals -- BlueShell (org.tunaos.BlueShell,
live in the index since the repo moved into the org) and stock upstream
Ghostty (com.mitchellh.ghostty). Neither was discoverable on the site: the
only trace was docs/blueshell/, auto-synced from the repo README.

An app is listed in six places, not one, so this adds all six for both:
projects.ts (the /projects card, the /<app> landing page and
/install?app=<id>), a src/pages/<app>.tsx wrapper, docs/<app>/index.md,
the sidebar entry, and both install catalogs.

docs/blueshell/ becomes hand-authored. sync-org-docs.mjs overwrites
docs/<slug>/ from each repo's README unconditionally, so without the
HAND_AUTHORED entry the next sync reverts this page. That sync is also why
the tree carried CONTRIBUTING.md and TUNA_OS_PROMOTION.md -- a contributor
guide and an internal migration runbook, neither of which is user-facing
documentation. Both are deleted; they remain in the repo they came from.

'ghostty' is listed in HAND_AUTHORED too. No such repo exists in the org
today, and the page documents an app TunaOS only republishes, so the entry
is there to keep it safe if one ever appears.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMBRswEeeX2kzVSwpbxCoy
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 6, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
tunaos-org 2492b1c Commit Preview URL

Branch Preview URL
Sep 06 2026, 08:41 AM

`.ste-budget` is 0, so one finding fails the job. Rewrites the sentence
rather than opting the file out.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMBRswEeeX2kzVSwpbxCoy
@hanthor

hanthor commented Sep 6, 2026

Copy link
Copy Markdown
Member Author

CI status

Fixed (mine): Simplified Technical English — one 4-word noun cluster in docs/ghostty/index.md. .ste-budget is 0, so a single finding fails the job. Reworded rather than opted out; node scripts/ste-lint.mjs --summary is now clean.

Pre-existing on main, not introduced here — both verified by checking out origin/main and running the same commands:

Check Evidence
Markdown Lint main produces 4017 findings against a budget of 2834. This branch produces 4008 — nine fewer, because it deletes two synced files. The gate has been red since before this PR (see #368, same failure).
Node.js Syntax & Tests Fails in check-install-commands on bluefin-cli, corral-vm and tavern — all in docs/bluefin-cli/index.md and docs/homebrew-tap/index.md, files this PR does not touch. Identical output on origin/main. These are tuna-os/homebrew-tap formulas that stopped resolving some time after 2026-09-03, when #368 last saw this job green.

Both look worth their own issue; neither blocks this PR.

Build tunaos-org, Internal Link Check, Workers Builds and both bootstrap jobs pass.

@hanthor
hanthor merged commit 1cbe18d into main Sep 6, 2026
6 of 8 checks passed
@hanthor
hanthor deleted the flatpak/blueshell-ghostty-pages branch September 6, 2026 08:56
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