Skip to content
npm scripts & commands

npm scripts & commands

View raw
On this page

ทุก script ใน package.json (ตรวจครบโดย npm run docs:check) ใช้ Node 22+ (export PATH=/tmp/node22/bin:$PATH บนเครื่อง box ของโปรเจกต์นี้)

คำสั่ง ทำอะไร ใช้เมื่อ
npm run dev next dev ที่ :3000 พร้อม Cloudflare bindings ใน dev พัฒนาประจำวัน
predev, prebuild, pretest, pretypecheck node scripts/build-docs.mjs อัตโนมัติก่อน dev / build / test / typecheck สร้าง docs bundle ใหม่ทุกครั้ง ไม่ต้องรันเอง
npm run build next build (target Node) ตรวจ build หรือ deploy แบบ Node server
npm run start next start รันผล build แบบ Node
npm run lint eslint ก่อน commit
npm test (test) vitest run ก่อน commit; CI
npm run test:watch vitest แบบ watch ระหว่างเขียน test
npm run typecheck tsc --noEmit ก่อน commit; CI
npm run export -- <id> [opts] tsx scripts/export-template.ts เขียน setup.sh/ps1/README ของเทมเพลตลงดิสก์ ทดสอบเทมเพลต end-to-end
npm run cf:build opennextjs-cloudflare build → .open-next/ ตรวจว่า build เป็น Worker ได้
npm run preview build + opennextjs-cloudflare preview ใน workerd ที่ :8787 ตรวจพฤติกรรม/ภาพแบบ production
npm run deploy build + opennextjs-cloudflare deploy ต้องได้รับอนุมัติก่อน ดู deploy-cloudflare.md
npm run cf:typegen wrangler types ... → cloudflare-env.d.ts หลังแก้ binding ใน wrangler.jsonc
npm run db:migrate:local wrangler d1 migrations apply nvx-db --local ทดสอบ migration ในฐานข้อมูลจำลองบนเครื่อง
npm run db:migrate:remote wrangler d1 migrations apply nvx-db --remote ต้องได้รับอนุมัติก่อน apply บน D1 จริง ดู d1-database.md
npm run db:migrations:list wrangler d1 migrations list nvx-db --remote ดู migration ที่ยังไม่ได้ apply (อ่านอย่างเดียว ต้องมี token)
npm run docs:check node scripts/docs-check.mjs ตรวจเอกสาร (ความยาว ลิงก์ id env scripts manifest) ก่อน commit; CI (-- --report พิมพ์จำนวนตัวอักษรต่อหน้า)
npm run docs:bundle node scripts/build-docs.mjs คอมไพล์ docs/**/*.md → src/generated/docs-bundle.json, docs-nav.json, public/docs-search-index.json ดูผลเร็ว ๆ หลังแก้เอกสาร (-- --check ล้มถ้า Mermaid ยังไม่มี SVG)
npm run docs:diagrams node scripts/render-diagrams.mjs เรนเดอร์บล็อก Mermaid เป็น public/docs-assets/diagrams/<hash>.svg หลังแก้ diagram (ต้องมี Playwright: PLAYWRIGHT_DIR=/tmp/pw npm run docs:diagrams)
npm run docs:pdf node scripts/docs-pdf.mjs สร้าง docs/dist/NVX-User-Guide.pdf จาก docs/user-guide/ หลังแก้คู่มือผู้ใช้ (ต้องมี Chromium ของ Playwright และฟอนต์ไทย)
postinstall node scripts/patch-opennext.mjs (อัตโนมัติหลัง npm install) patch adapter สำหรับ Next 16.4

ตัวเลือกของ npm run export#

--name my-app ชื่อโปรเจกต์ · --pm npm|pnpm|yarn · --py pip|uv · --addons typescript,tailwind (ว่าง = ไม่มี add-on) · --out ./out (ค่าเริ่มต้น out/<id>) · --lang en|th

bash
npm run export -- fastapi-ai --py uv --addons testing,docker --out /tmp/fastapi --lang th

สคริปต์อื่นในโฟลเดอร์ scripts/#

ไฟล์ วิธีรัน หน้าที่
scripts/gen-brand-icons.mjs node scripts/gen-brand-icons.mjs สร้าง src/components/brand/brand-icons.data.ts จาก simple-icons (รันหลังเพิ่ม id โลโก้)
scripts/patch-opennext.mjs อัตโนมัติ (postinstall) patch preview-props.json
scripts/docs-check.mjs npm run docs:check docs freshness
scripts/docs-pdf.mjs npm run docs:pdf PDF คู่มือผู้ใช้
scripts/build-docs.mjs npm run docs:bundle (และ pre-hooks) docs bundle สำหรับ /docs (docs-site.md)
scripts/render-diagrams.mjs npm run docs:diagrams SVG ของ Mermaid

คำสั่ง wrangler ที่ใช้บ่อย (ต้องมี token และอนุมัติสำหรับคำสั่งที่เขียน)#

npx wrangler deployments list --name nvx-stack-builder (อ่าน), npx wrangler secret put OPENAI_API_KEY (เขียน, ผ่าน stdin), npx wrangler rollback <id> --name nvx-stack-builder -m "..." (เขียน), npx wrangler tail nvx-stack-builder (อ่าน)

Source: docs/reference/npm-scripts.md · /docs/reference/npm-scripts.md