KuJiTool

🚀 Hướng dẫn chạy Flutter Web (đã build) bằng Node.js

Tài liệu này hướng dẫn cách chạy sản phẩm Flutter Web đã được build sẵn
✅ Không cần Flutter SDK
✅ Chỉ cần Node.js

---

1️⃣ Yêu cầu môi trường

• Node.js >= 14
• Thư mục web đã được build sẵn

---

2️⃣ Cấu trúc thư mục sau khi build

project-root/
├── build/
│   └── web/
│       ├── index.html
│       ├── main.dart.js
│       ├── flutter.js
│       ├── assets/
│       └── canvaskit/

---

3️⃣ Cách chạy web bằng Node.js (Khuyến nghị ⭐)

Bước 1: Cài server tĩnh serve

npm install -g serve

---

Bước 2: Chạy web

serve

Truy cập trên trình duyệt:

http://localhost:3000

---

4️⃣ Chạy với port khác (tuỳ chọn)

serve -s -l 8080

Truy cập:

http://localhost:8080

---

5️⃣ Lỗi 404 khi reload trang

❌ Nguyên nhân

Flutter Web là Single Page Application (SPA)
Khi reload /login, /dashboard → server tìm file vật lý → không tồn tại → 404

---

✅ Cách khắc phục

Luôn chạy bằng lệnh:

serve 

❌ Không dùng:

serve

---

6️⃣ Không dùng các cách sau ❌

❌ Mở trực tiếp file index.html
❌ Dùng Live Server của VSCode

Những cách trên không hỗ trợ SPA routing.

---

7️⃣ Tóm tắt nhanh

Mục đích	Lệnh
Cài server	npm install -g serve
Chạy web	serve
Đổi port	serve -l 8080

---

✅ Hoàn tất!
Sản phẩm Flutter Web đã build có thể chạy độc lập bằng Node.js.