การดาวน์โหลด · Downloads (setup.sh / setup.ps1 / README / zip)

ขั้น Export ของตัวสร้างมีไฟล์ให้ดาวน์โหลด 4 แบบ ทั้งหมดสร้างในเบราว์เซอร์ของคุณเอง (client-side) จากขั้นตอนที่แสดงอยู่บนหน้าจอ ไม่มีอะไรถูกส่งมาที่เซิร์ฟเวอร์ของเรา ในหน้านี้เราจะเปิดให้ดูว่าสคริปต์ข้างในหน้าตาเป็นอย่างไร และทำไมเราเขียนแบบนั้น

ไฟล์แต่ละแบบ#

ข้างใน setup.sh มีอะไร และทำไมเราเขียนแบบนี้#

1. โหลด nvm ก่อน (. "$NVM_DIR/nvm.sh") เพราะ nvm เป็น shell function ไม่ใช่ไฟล์โปรแกรม สคริปต์ที่ไม่ได้ source จะหา nvm ไม่เจอ
2. set -eo pipefail หยุดทันทีเมื่อคำสั่งใดล้มเหลว เพื่อไม่ให้ขั้นต่อไปทำงานบนสถานะที่พัง
3. ฟังก์ชัน step พิมพ์หัวข้อ ==> 3/7 ... และ verify รันคำสั่งตรวจสอบ ถ้าไม่ผ่านจะเตือน [warn] แต่ไม่หยุดสคริปต์
4. ไฟล์เริ่มต้นเขียนด้วย heredoc แบบ <<'NVX_EOF' (มี quote) จึงไม่มีการแทนค่าตัวแปร sanitizer ปฏิเสธไฟล์ที่มีบรรทัด NVX_EOF เพื่อกันการหลุดออกจาก heredoc
5. ขั้นที่มี requires (เช่น nvm) ถูกห่อด้วย if command -v nvm ... ถ้าไม่พบจะข้ามพร้อมคำเตือน
6. ขั้นชนิด longRunning (dev server), publish (npm publish, twine upload) และ manual ถูก คอมเมนต์ไว้ พร้อมหมายเหตุ เพราะ dev server จะค้างสคริปต์ไว้ และการ publish เป็นการกระทำสาธารณะที่ย้อนกลับไม่ได้

setup.ps1 ทำแบบเดียวกันด้วย $ErrorActionPreference = "Stop", ฟังก์ชัน Step, Assert-Ok (ตรวจ $LASTEXITCODE หลังทุกคำสั่ง), Write-NvxFile (เขียนไฟล์ด้วย here-string @' ... '@) และ Verify

วิธีรันอย่างปลอดภัย#

เราแนะนำให้อ่านก่อนรันเสมอ คัดลอกคำสั่งด้านล่างไปใช้ได้เลย:

mkdir ~/projects && cd ~/projects
less setup.sh          # อ่านทุกบรรทัดก่อน
bash setup.sh

Get-Content .\setup.ps1 | more
powershell -ExecutionPolicy Bypass -File .\setup.ps1

-ExecutionPolicy Bypass ใช้เฉพาะการรันครั้งนี้ ไม่เปลี่ยน policy ของเครื่อง

ภายใน starter zip#

<project>-starter/
  setup.sh            (สิทธิ์ 755)
  setup.ps1
  README.md           (มี share link)
  nvx-stack.json      (generator, shareUrl, config, steps[] แบบอ่านด้วยเครื่องได้)
  starter-files/...   (ทุกไฟล์ที่ขั้นตอนต่าง ๆ จะเขียน ณ path เดิม)

เราใส่ nvx-stack.json ไว้เผื่อเครื่องมืออัตโนมัติหรือ AI agent ที่ต้องการอ่านลำดับขั้นตอนโดยไม่ต้อง parse shell script

เคล็ดลับจากทีมเรา#

• รันในโฟลเดอร์ว่างเสมอ ขั้นแรกของเทมเพลตส่วนใหญ่สร้างโฟลเดอร์ {{name}} แล้ว cd เข้าไป
• หลังสคริปต์จบ ให้รันขั้นที่คอมเมนต์ไว้ (เช่น npm run dev) ในเทอร์มินัลแยก
• ผู้ร่วมพัฒนาสร้างสคริปต์จาก CLI ได้ด้วย npm run export -- <templateId> (ดู npm-scripts.md)

อ้างอิง#

src/lib/scripts.ts, src/lib/download.ts, scripts/export-template.ts