Skip to content

docs: explain the framework's architecture#92

Closed
Sukuna0007Abhi wants to merge 1 commit intometacall:masterfrom
Sukuna0007Abhi:docs/architecture
Closed

docs: explain the framework's architecture#92
Sukuna0007Abhi wants to merge 1 commit intometacall:masterfrom
Sukuna0007Abhi:docs/architecture

Conversation

@Sukuna0007Abhi
Copy link

Add docs/dev/Architecture.md covering:

  • Repository layout and crate dependency graph
  • Responsibilities of all 11 crates
  • Full build pipeline (SSR + SSG + client hydration)
  • SSR request lifecycle (rendered once at startup via MetaCall)
  • Dev mode hot-reload flow (two-channel broadcast architecture)
  • Polyglot API routes (src/api/*.js via MetaCall)
  • MetaCall integration points
  • Key data structures (Manifest, SourceDirContainer, PageEntry, RebuildType)

Also update docs/README.md to link to the new developer docs section.

Closes #19

Add docs/dev/Architecture.md covering:
- Repository layout and crate dependency graph
- Responsibilities of all 11 crates
- Full build pipeline (SSR + SSG + client hydration)
- SSR request lifecycle (rendered once at startup via MetaCall)
- Dev mode hot-reload flow (two-channel broadcast architecture)
- Polyglot API routes (src/api/*.js via MetaCall)
- MetaCall integration points
- Key data structures (Manifest, SourceDirContainer, PageEntry, RebuildType)

Also update docs/README.md to link to the new developer docs section.

Closes metacall#19
@fahdfady
Copy link
Collaborator

fahdfady commented Mar 6, 2026

I don't think I will accept an AI-generated documentation. Especially documentations should not be written by AI (and that's why we need to clarify what is acceptable or not via #90 , so it's not your problem this is on our side)
I don't want to discourage You but I won't merge a PR about the Architecture when you didn't touch enough components in the system to begin with. Maybe start with smaller contributions & we can help.

@fahdfady fahdfady closed this Mar 6, 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.

docs: Explain the framework's architecture

2 participants