← Cloudflare Pages / pages / framework-guides

SolidStart

Solid ↗ je open-source framework pro webové aplikace zaměřený na tvorbu výkonných aplikací s moderním vývojářským zážitkem založeným na JSX.

V tomto průvodci vytvoříte novou aplikaci Solid implementovanou pomocí SolidStart ↗ (metaframework Solidu) a nasadíte ji přes Cloudflare Pages.

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

Chcete-li použít create-cloudflare k vytvoření nového projektu Solid spusťte následující příkaz:

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

Budete vyzváni k výběru šablony (starter). Zvolte libovolnou z dostupných možností. Poté budete dotázáni, zda chcete povolit Server Side Rendering. Odpovězte yes. Nakonec budete dotázáni, zda chcete použít TypeScript, zvolte buď yes nebo no.

create-cloudflare poté nainstaluje závislosti, mimo jiné Wrangler CLI a adaptér SolidStart Cloudflare Pages a položí vám otázky k nastavení.

Jakmile nainstalujete závislosti projektu, spusťte aplikaci:

npm run dev

Abyste nakonfigurovali SolidStart tak, aby ho bylo možné nasadit na Cloudflare Pages, upravte jeho konfigurační soubor takto:

import { defineConfig } from "@solidjs/start/config";

export default defineConfig({
+  server: {
+    preset: "cloudflare-pages",

+    rollupConfig: {
+      external: ["node:async_hooks"]
+    }
+  }
});

Všechny průvodce frameworky předpokládají, že již máte základní znalosti Git ↗. Pokud s Gitem začínáte, podívejte se na tento shrnutá příručka ke Gitu ↗ jak nastavit Git na svém lokálním počítači.

Pokud klonujete přes SSH, musíte vygenerujte SSH klíče ↗ na každém počítači, který používáte pro push nebo pull z GitHubu.

Viz dokumentace GitHub ↗ a Dokumentace Git ↗ s dalšími informacemi.

Vytvořte nový repozitář GitHub na repo.new ↗. Po vytvoření nového repozitáře přejděte do adresáře nově vytvořeného projektu a v terminálu spusťte následující příkazy, kterými připravíte a odešlete svou místní aplikaci na GitHub:

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Pokud používáte create-cloudflare(C3) ↗ k vytvoření nového projektu Solid nainstaluje C3 všechny závislosti, které projekt potřebuje, a vyzve vás k nasazení projektu přes CLI. Pokud jej nasadíte, web se zveřejní a získáte URL adresu nasazení.

Chcete-li nasadit svůj web do Pages:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte Vytvoření aplikace.

3. Vyberte Pages kartě.

4. Vyberte Importujte existující repozitář Git.

5. Vyberte nově vytvořený repozitář GitHub a poté vyberte Zahájit nastavení.

6. V Nastavení sestavení a nasazení sekci uveďte následující informace:

Po nakonfigurování webu můžete spustit první nasazení. Měli byste vidět, jak Cloudflare Pages instaluje npm, závislosti projektu a sestavuje web, než ho nasadí.

Po nasazení webu získáte pro svůj projekt jedinečnou subdoménu na *.pages.dev. Pokaždé, když do svého repozitáře Solid committnete nový kód, Cloudflare Pages automaticky znovu sestaví váš projekt a nasadí ho. Získáte také přístup k náhledová nasazení u nových pull requestů, abyste si mohli prohlédnout, jak změny na vašem webu vypadají, než je nasadíte do produkce.

Dokončením tohoto návodu jste úspěšně nasadili svůj web Solid na Cloudflare Pages. Chcete-li začít s dalšími frameworky, podívejte se na seznam návodů pro frameworky.