nowaki 0.1.0

A fast full-stack web framework with a Rust toolchain and islands architecture
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

<div align="center">

# Nowaki (野分) 🌀

**Rust製ツールチェーンを核とする、爆速フルスタックWebフレームワーク**

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#status)

Next.js の遅さへの答え — デフォルトでクライアントJSゼロ、Rustバイナリで即起動。

</div>

---

## Nowaki とは

Nowaki（野分 = 台風の古語）は、Next.js の構造的な遅さを出発点に設計したフルスタックフレームワークです。バンドラー／変換／開発サーバーを **Rust + [oxc](https://oxc.rs)** で構築し、レンダリングは **Islands Architecture** を採ることで、ページが送るクライアントJSを「島」の分だけに抑えます。

| Next.js の課題 | Nowaki の回答 |
|---|---|
| `next dev` の起動が遅い | Rustバイナリが即起動・オンデマンド変換（**例アプリで起動 ~90ms**） |
| HMR が重い | oxc によるms級の単一ファイル再変換 |
| ページのJSが肥大化 | **Islands**: 明示した島以外はクライアントJSゼロ |
| ビルドが遅い | oxc minifier・コンテンツハッシュキャッシュ |

> [!WARNING]
> **Status: alpha.** 設計は固まりつつありますが、APIは予告なく変わります。本番利用はまだ推奨しません。

## 特徴

- ⚡ **Rustツールチェーン** — oxc (parser / transformer / codegen / resolver) 上に構築したオンデマンド変換パイプライン
- 🏝️ **Islands Architecture** — デフォルトJSゼロ。`islands/` のコンポーネントだけがハイドレートされる
- 📁 **ファイルベースルーティング** + Remix風 `loader`
- 🔌 **npmエコシステム互換** — SSRは Rust が管理する Node サイドカー (Preact) へ委譲

## クイックスタート

前提: Rust (stable), Node.js >= 22, pnpm

```bash
git clone https://github.com/nowaki-dev/nowaki
cd nowaki
pnpm install
cargo build -p nowaki

# サンプルアプリで開発サーバー起動
./target/debug/nowaki dev examples/hello
# → http://127.0.0.1:3000

# 本番用にビルド（client: content-hash付きESM + manifest / server: SSR用ESM）
./target/debug/nowaki build examples/hello
# → examples/hello/dist/{client,server}/ に出力

# ビルド済みアプリを本番モードで配信
./target/debug/nowaki start examples/hello --port 3000
# → http://127.0.0.1:3000 （静的配信 + prod SSR、HMRなし）
```

## 書き味

```tsx
// routes/index.tsx — loader はサーバーでのみ実行される
import Counter from "../islands/Counter.tsx";

export const loader = async () => {
  return { message: "Nowaki へようこそ" };
};

export default function Home({ data }) {
  return (
    <main>
      <h1>{data.message}</h1>
      <Counter start={5} />   {/* この島だけがクライアントでハイドレートされる */}
    </main>
  );
}
```

ページ本体と `loader` のコードはブラウザに送られません。`islands/Counter.tsx` のJSだけが配信されます。

## プロジェクト構成

```
crates/nowaki-core       バンドラーコア (変換 / 解決 / キャッシュ)
crates/nowaki            CLI + 開発サーバー (axum) + HMR + サイドカー管理
packages/nowaki-runtime  @nowaki/runtime (islandsクライアント / SSRサイドカー / Nodeローダーフック)
examples/hello           サンプルアプリ
```

設計の詳細・アーキテクチャ図は **[DESIGN.md](./DESIGN.md)**、今後の計画は **[ROADMAP.md](./ROADMAP.md)** を参照してください。

## コントリビュート

歓迎します！ まずは [CONTRIBUTING.md](./CONTRIBUTING.md) をご覧ください。alpha のうちは、コードを書く前に Issue で方針を相談するのが確実です。

## ライセンス

[MIT](./LICENSE) © 2026 [Voredge](https://voredge.com)

<sub>Built and maintained by Voredge. 「Nowaki」「野分」は台風を意味する日本語の古語です。</sub>