核心 < 10kb · 无虚拟 DOM · 零框架开销

brk

the best-architecture to write jsx.

一个微前端的骨架。

不引入虚拟 DOM,不做 diff,不做状态管理。
组件只渲染一次,更新由你掌控。

index.html
<script src="/static/init.js"></script>
<script>brk.render({ load: "/dist/page.mjs" })</script>
page.tsx
const vino = () => (
  <brk.card>
    <h1>Hello World</h1>
    <div css="height: 1px; margin: 8px 0"/>
    <p cls="muted">可以开始使用 brk 了</p>
  </brk.card>
);

export const page = { vino };
✓ 编译产物 ≈ 100% 是你的应用代码
< 10 kb
init.js 运行时
0 依赖
纯 TypeScript
1 次渲染
组件只执行一次
ESM
页面即模块
设计取舍

框架能不管的,就都不管

下面四条不是特性,而是决定。它们解释了为什么 brk 能做到这么小,也解释了它会让你在哪些地方需要多写一点。

01

渲染一次

组件函数只执行一次,DOM 只生成一次。没有 hooks,没有重渲染,UI = f(state) 由你自己维持。

02

不做调度

更新交给 replaceChildren 和 textContent,刷新粒度由你决定。框架不介入状态到 DOM 的同步。

03

全局能力

init.js 把 jsx 与 globalThis._brk_ 一次性注入,页面产物里只有你的应用代码。

04

可整体替换

init.js 是源码不是黑盒。你可以覆盖 brk.opens,甚至重写整套运行时。

适用边界

它适合什么,不适合什么

// 适合

  • 多页应用、后台系统、微前端外壳
  • 在既有系统里增量引入的一层渲染骨架
  • 对体积敏感、想要完全掌控更新时机的团队
  • 需要页面产物 100% 是自身业务代码的场景

// 不适合

  • 期望响应式自动更新、数据驱动的视图
  • 期望开箱即用的组件生态与脚手架
  • 期望 React / Vue 那样的开发体验与心智模型
  • 需要 SSR 直出完整 HTML 内容的项目
文档

板块

指南已经完成。其他板块会陆续补齐——每个板块都会独立成页,逐步深入。