← Cloudflare Workers / workers / framework-guides / web-apps / more-web-frameworks

Waku

V tomto průvodci vytvoříte nový Waku ↗ aplikaci a nasaďte ji na Cloudflare Workers (s novým Workers Assets). Waku je minimalistický React framework vytvořený pro React 19 ↗ a React Server Components ↗. Použití Server Components je zcela volitelné. Lze je nastavit tak, aby se Server Components spouštěly při buildu a výstupem bylo statické HTML, nebo tak, aby běžely s dynamickým renderováním React serveru. Je postaveno na Hono ↗ a Vite ↗.

Použijte create-cloudflare ↗ CLI (C3) pro nastavení nového projektu. C3 vytvoří nový adresář projektu, spustí oficiální nastavovací nástroj frameworku Waku a nabídne možnost okamžitého nasazení.

Chcete-li použít create-cloudflare pro vytvoření nového projektu Waku s Workers Assets spusťte následující příkaz:

npm create cloudflare@latest my-waku-app -- --framework=waku

Při nastavení vyberte následující možnosti:

• Pro S čím byste chtěli začít?, vyberte Framework Starter.
• Pro Jaký vývojový framework chcete použít?, vyberte Waku.
• Dokončete CLI průvodce daného frameworku.
• Pro Chcete používat git pro správu verzí?, vyberte Yes.
• Pro Chcete nasadit svou aplikaci?, vyberte No (před nasazením provedeme ještě několik změn).

Po nastavení projektu přejděte do jeho adresáře spuštěním následujícího příkazu:

cd my-waku-app

Jakmile vytvoříte projekt, spusťte v jeho adresáři následující příkaz, který spustí lokální server. Díky tomu si budete moci projekt během vývoje prohlížet lokálně.

npm run dev

Váš projekt lze nasadit na *.workers.dev subdoména nebo Custom Domain, z vlastního počítače nebo z libovolného systému CI/CD, včetně vlastní od Cloudflare.

Následující příkaz sestaví a nasadí váš projekt. Pokud používáte CI, nezapomeňte aktualizovat "deploy command" konfiguraci podle potřeby.

npm run deploy

Aplikaci Waku lze plně integrovat s Cloudflare Developer Platform, a to jak při lokálním vývoji, tak v produkčním prostředí, pomocí bindings k jednotlivým produktům. Soubor Dokumentace Waku pro Cloudflare ↗ poskytuje informace o konfiguraci vazeb a o tom, jak k nim můžete přistupovat ve svých React Server Components.

Statické assets ve své aplikaci Waku můžete obsluhovat tak, že je přidáte do ./public/ adresář. Mezi běžné příklady patří obrázky, styly, písma a webové manifesty.

Během procesu sestavení Waku zkopíruje .js, .css, .html, a .txt soubory z tohoto adresáře do výsledného výstupu prostředků. .txt soubory slouží k ukládání dat, která používají Server Components vykreslované v době sestavení.

Cloudflare se ve výchozím nastavení nejprve pokusí porovnat cestu požadavku s cestou ke statickému assetu, která vychází ze struktury souborů nahraného adresáře s assety. Jde buď o adresář určený assets.directory ve vaší konfiguraci Wrangler nebo, v případě Cloudflare Vite plugin, výstupní adresář sestavení klienta. Pokud takový soubor neexistuje, spustíme Worker, pokud je k dispozici. Pokud Worker není k dispozici, nebo pokud Worker následně použije asset binding, Cloudflare přejde na chování nastavené pomocí not_found_handling.

Viz dokumentace ke směrování další informace o tom, jak funguje směrování se statickými aktivy a jak toto chování přizpůsobit.