ローカルサーバーの起動
それはよくある現象で、原因はほぼこれです👇
👉 ローカルで index.html を直接開いている(file://)から
🎯 結論
Webstudioのエクスポートは
👉 **「サーバーで配信される前提」**で作られている
なので
👉 直接開くと崩れる
❗ 主な原因
① パスの問題(これが一番多い)
HTMLの中👇
<script src="/assets/main.js"></script>
👉 / は本来
https://example.com/assets/...を意味する
でもローカルだと👇
file:///assets/...を見に行く → 存在しない
👉 JS / CSSが読み込めない → 崩れる
② JavaScriptが動かない
-
一部ブラウザ制限(CORSなど)
-
module読み込み失敗
👉 レイアウト崩壊
③ ルーティング前提(SPA)
-
内部リンクが
/aboutなどになっている -
file://では動かない
④ 画像・フォントのパス
-
絶対パス指定
-
CDN前提
🚀 解決方法(これだけやればOK)
✅ 方法① ローカルサーバーで起動(推奨)
npx serve
または
npx http-server
👉 これで👇
http://localhost:3000
からアクセス
👉 完全に正常表示される
✅ 方法② Cloudflareにアップ
👉 Cloudflare Pagesにアップ
→ 本番環境と同じ挙動
✅ 方法③ VSCode使うなら
- Live Server拡張
👉 右クリック → Open with Live Server
💡 なぜこうなるのか(本質)
最近のフロントエンドは👇
-
絶対パス前提
-
CDN前提
-
サーバー前提
👉 file://は想定外
⚠️ よくある誤解
「HTML壊れてる?」
👉 ❌違う
👉 ✅ 開き方が違うだけ
🎯 まとめ
👉 ダメな開き方
- index.htmlをダブルクリック
👉 正しい開き方
- ローカルサーバー or Cloudflare
OK、最短で“今あるファイルをそのまま公開”する方法だけに絞ります👇
(Gitも設定も不要・30秒〜1分)
🚀 一瞬で公開する方法
👉 Cloudflare **Pagesの「Upload assets」**を使う
🧩 手順(コピペでOK)
① Cloudflareにログイン
👉 ダッシュボードへ
② Pagesを開く
-
左メニュー → Workers & Pages
-
「Pages」タブ
③ プロジェクト作成
👉 Create application(作成)
④ 「Upload assets」を選択
👉 これが最速ルート
(Git連携じゃない方)
⑤ ファイルをアップロード
👉 Webstudioで出力したフォルダ or ZIPをそのままドラッグ
-
index.html -
assets/ -
その他全部
👉 フォルダ丸ごとが重要
⑥ デプロイ
👉 「Deploy」クリック
🎉 完了
- 数秒でURL発行
例:
https://xxxx.pages.dev
👉 すぐ見れる
⚠️ ここだけ注意
❗ フォルダ構成
NG👇
dist/
index.html
👉 distごとアップするとズレる
OK👇
index.html
assets/
👉 中身をアップ
💡 コツ(成功率100%)
-
ZIPでもOK
-
ルートにindex.htmlがある状態にする
🔥 この方法の強さ
-
Git不要
-
CLI不要
-
設定ゼロ
-
最速公開
👉 検証・試作に最強
🚀 次のステップ(必要なら)
-
独自ドメイン設定
-
自動デプロイ(Git連携)
-
Astroとの統合
👉 Webstudioで作ったデザインを活かしつつ、Astro + Cloudflareで運用する方法を最短で整理します。
🎯 結論(先に)
👉 やることはこれだけ
-
Webstudio でHTMLを書き出す
-
Astro に組み込む
-
Cloudflare にデプロイ
👉 =デザインはWebstudio、運用はAstro
🚀 全体構成
Webstudio(デザイン)
↓
Astro(ページ管理・ルーティング)
↓
Cloudflare(公開)
🧩 STEP1:Webstudioから書き出し
-
「Export」でZIPダウンロード
-
中身👇
index.html
assets/
🧩 STEP2:Astroに取り込む
① プロジェクト作成
npm create astro@latest
cd プロジェクト名
npm install
② ファイル配置
HTML → Astroへ
src/pages/index.astro
中身👇(変換)
---
---
<html>
<body>
<!-- WebstudioのHTML貼り付け -->
</body>
</html>
③ assets配置
public/assets/
👉 Webstudioのassetsをここにコピー
④ パス修正(重要)
WebstudioのHTML👇
<link href="/assets/style.css">
👉 そのままでOK(Astroはpublic配信)
🧩 STEP3:動作確認
npm run dev
🧩 STEP4:Cloudflareにデプロイ
方法①(おすすめ)
👉 GitHub連携 → Pages
方法②(最速)
👉 Pages「Upload assets」
⚡ 応用(ここから本番)
CMS連携
👉 Storyblok
npm install @storyblok/astro
👉 Webstudioの静的部分+CMS動的化
コンポーネント化
HTMLを分割👇
Header.astro
Footer.astro
👉 再利用可能
💡 この構成の強み
-
デザイン:Webstudio(ノーコード)
-
開発:Astro(高速)
-
配信:Cloudflare(爆速)
👉 実務でかなり強い構成
⚠️ ハマりポイント
❌ そのまま貼ると崩れる
原因👇
-
JS依存
-
CSSパス
👉 assets確認
❌ script動かない
<script type="module">
👉 Astroの制約あり
🎯 まとめ
👉 一番シンプルな統合
-
Webstudio → HTML書き出し
-
Astroに貼る
-
Cloudflareにデプロイ
👉 これでOK