docs: integrate architecture diagrams and polish marketing surfaces#35
Merged
Conversation
Consolidate deduplication, global counters, recent list, and daily counter into a single Lua eval so a KV failure cannot leave partial state.
Use inline styles for stellar color levels since Tailwind JIT does not generate bg-stellar opacity modifiers. Fix hover panel layout jump and preserve selection when moving the cursor to the detail panel.
Add a secondary action to return to mode selection and label the rerun button with the active scenario name.
Add an inline address input that routes directly to mainnet analyze and refresh the hero label styling.
Introduce /content as the marketing hub for videos and articles, update nav and footer links, and normalize page title punctuation.
Add reproducible diagram scripts with shared styling and a render-all entrypoint. Ignore Python bytecode artifacts.
Replace inline Mermaid blocks with pre-rendered SVG and PNG exports and document the export workflow in docs/diagrams/README.md.
Reorganize the project README with the system architecture diagram and tighter copy on reserves, manual close friction, and the trust model.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Replaces inline Mermaid blocks in the architecture document with pre-rendered SVG/PNG exports, adds a reproducible Python render pipeline, and refreshes the marketing site with a content hub, a hero account analyzer, and several small UI/backend fixes.
Motivation
Inline Mermaid diagrams render inconsistently across GitHub, Mintlify, and local previews. Exporting them to versioned assets gives the architecture doc and README a single, stable visual source. The marketing changes make it easier for visitors to jump straight into analysis and discover videos alongside blog posts.
Changes
Architecture diagrams
scripts/diagrams/— nine diagram scripts, shared_style.py, andrender-all.pydocs/diagrams/output/docs/architecture.mdwith image embedsdocs/diagrams/README.mdwith the export workflow and output index**/__pycache__/in.gitignoreDocumentation
README.mdaround the system architecture diagram and tighter copy on reserves, manual close friction, and the trust model—→-) across docs and UI stringsMarketing UI
HeroAccountInput— inline address field on the landing page that routes to/mainnet/analyze?source=…/contenthub — videos and blog posts in one place; nav/footer link renamed from "Blog" to "Content" (existing/blogroutes remain active)bg-stellar/xmodifiers); fixed-height detail panel; hover state survives cursor travel to the panelBackend
recordMerge— consolidate deduplication, global counters, recent list, and daily counter into a single Luaeval, preventing partial KV state on failureRegenerating diagrams
Requires Python with the diagram dependencies used by the scripts (see
scripts/diagrams/_style.py). Re-run after editing anyscripts/diagrams/*.pysource, then commit the updated files indocs/diagrams/output/.Test plan
bun type-checkbun lintbun test(unit tests pass; Playwright specs excluded per project convention)G…addresses and navigates correctly/contentrenders video cards and blog post list/statsCommit history
fix(backend)fix(ui)feat(ui)feat(ui)feat(ui)chore(diagrams)docs(diagrams)docsdocs