Skip to content

docs: add Fluent system architecture guide#134

Open
hedwig0x wants to merge 4 commits intofluentlabs-xyz:mainfrom
hedwig0x:docs/fluent-system-architecture
Open

docs: add Fluent system architecture guide#134
hedwig0x wants to merge 4 commits intofluentlabs-xyz:mainfrom
hedwig0x:docs/fluent-system-architecture

Conversation

@hedwig0x
Copy link
Copy Markdown

@hedwig0x hedwig0x commented Apr 3, 2026

Summary

Add a new architecture doc for Fluent at a mid-technical level, focused on system design rather than code internals.

  • New page: docs/knowledge-base/system-architecture.md
  • Covers architecture from node shell -> execution coordination -> runtime layer
  • Explains blended execution model, routing model, interruption protocol, syscall layering, gas/fuel model, and upgrade/security boundaries

Source alignment

This draft was built from:

  • fluentlabs-xyz/tech-book architecture chapters (blended execution vision, EE model, interruption concepts)
  • current fluentbase/docs/* runtime docs (00-08) for implementation-accurate behavior and terminology

When historical tech-book phrasing and current runtime docs differ, this page follows current Fluentbase runtime docs.

Validation

  • npm ci
  • npm run build (Docusaurus build succeeds)

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 3, 2026

@hedwig0x is attempting to deploy a commit to the Fluent Labs Inc Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

@vercel[bot] does not have sufficient permissions to trigger deployments.

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-docusaurus Ready Ready Preview, Comment Apr 3, 2026 7:16pm

Request Review

@hedwig0x
Copy link
Copy Markdown
Author

hedwig0x commented Apr 3, 2026

Update based on review feedback:

  • replaced the single compact page with a nested System Architecture section under Knowledge Base
  • expanded content into 9 focused pages to better match tech-book scope while staying implementation-aligned with current Fluentbase docs
  • emphasized architecture boundaries and integration challenges (routing/ownership, interruption/syscalls, state model, gas/fuel, upgrades/security)
  • re-ran docs build after restructuring (npm run build passes)

New section path:

  • docs/knowledge-base/system-architecture/

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

@hedwig0x does not have sufficient permissions to trigger deployments.

@hedwig0x
Copy link
Copy Markdown
Author

hedwig0x commented Apr 3, 2026

Moved System Architecture from nested to a top-level docs category () so it appears at the upper sidebar level. Build re-checked after move.

@hedwig0x
Copy link
Copy Markdown
Author

hedwig0x commented Apr 3, 2026

Correction: System Architecture now lives at top-level path docs/system-architecture/ (not under Knowledge Base), so it shows in the upper sidebar level as requested.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

@hedwig0x does not have sufficient permissions to trigger deployments.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

@hedwig0x does not have sufficient permissions to trigger deployments.

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