# react-thaizip documentation

> Scaffold Thai address components into React or Next.js projects with the react-thaizip CLI.

[Full documentation](/llms-full.txt)
[AI usage guide (ไทย)](/docs/guides/using-with-ai.md)
[AI usage guide (English)](/en/docs/guides/using-with-ai.md)

## ไทย

- [เริ่มต้นใช้งาน](/docs/getting-started.md): Scaffold คอมโพเนนต์ที่อยู่ไทยชิ้นแรกในโปรเจกต์ของคุณ
- [react-thaizip](/docs/index.md): เพิ่มคอมโพเนนต์ที่อยู่ไทยพร้อมใช้ให้โปรเจกต์ React และ Next.js
- [การแก้ปัญหา](/docs/troubleshooting.md): สาเหตุและคำสั่งกู้คืนสำหรับ init, add, Tailwind, dependencies และไฟล์ที่มีอยู่
- [แสดงที่อยู่แบบอ่านอย่างเดียว](/docs/components/address-display.md): จัดรูปแบบที่อยู่ไทยที่เลือกไว้แล้วให้เป็นข้อความอ่านง่าย ไม่ต้องโหลดดัชนีที่อยู่
- [ฟิลด์ที่อยู่สำหรับ react-hook-form](/docs/components/address-form-field.md): ครอบ cascade select ด้วย Controller ของ react-hook-form เพื่อผูกกับ validation และ state ของฟอร์มที่มีอยู่แล้ว
- [ฟอร์มที่อยู่แบบเต็ม](/docs/components/address-form.md): กรอกบ้านเลขที่ หมู่ ซอย ถนน พร้อมเลือกที่อยู่ตามลำดับชั้นในฟอร์มเดียว
- [ค้นหาที่อยู่แบบ autocomplete](/docs/components/autocomplete.md): ค้นหาที่อยู่ไทยจากข้อความที่พิมพ์ พร้อมค่าที่อยู่แบบมีโครงสร้าง
- [เลือกที่อยู่แบบลำดับชั้น](/docs/components/cascade-select.md): เลือกจังหวัด อำเภอหรือเขต และตำบลหรือแขวงตามลำดับ
- [การปรับแต่ง](/docs/guides/customization.md): เปลี่ยนภาษา ข้อความ class slots และ design tokens ของคอมโพเนนต์ที่ scaffold
- [การใช้งานร่วมกับฟอร์ม](/docs/guides/forms.md): ส่งค่าที่อยู่ไทยด้วยฟอร์มของเบราว์เซอร์ หรือเชื่อมต่อกับ state ของไลบรารีฟอร์ม
- [ใช้ react-thaizip กับ AI](/docs/guides/using-with-ai.md): ให้ AI scaffold และประกอบคอมโพเนนต์ที่อยู่ไทยจากซอร์สจริงในโปรเจกต์
- [คำสั่ง CLI](/docs/reference/cli.md): รูปแบบคำสั่ง flags, aliases และการเลือกคอมโพเนนต์ของ react-thaizip
- [การตั้งค่า](/docs/reference/config.md): รูปแบบ thaizip.config.json v4, สไตล์คอมโพเนนต์ และกฎการตรวจหาโปรเจกต์

## English

- [Get started](/en/docs/getting-started.md): Scaffold your first Thai address component into a project you own
- [react-thaizip](/en/docs/index.md): Ready-to-use Thai address components for React and Next.js projects
- [Troubleshooting](/en/docs/troubleshooting.md): Causes and exact recovery steps for init, add, Tailwind, dependencies, and existing files
- [Read-only address display](/en/docs/components/address-display.md): Format an already-resolved Thai address as readable text, with no address-index loading
- [react-hook-form address field](/en/docs/components/address-form-field.md): Wrap the cascade select in react-hook-form's Controller to bind it to an existing form's validation and state
- [Full address form](/en/docs/components/address-form.md): Capture house number, moo, soi, and street alongside an ordered address selection in one form
- [Address autocomplete](/en/docs/components/autocomplete.md): Search Thai addresses from typed text and receive a structured address value
- [Address cascade select](/en/docs/components/cascade-select.md): Choose province, district, and sub-district in order
- [Customization](/en/docs/guides/customization.md): Change locale, text, class slots, and design tokens in scaffolded components
- [Forms](/en/docs/guides/forms.md): Submit Thai address values with browser forms or connect them to form-library state
- [Use react-thaizip with AI](/en/docs/guides/using-with-ai.md): Help an AI agent scaffold and compose Thai address components from the real project source
- [CLI reference](/en/docs/reference/cli.md): react-thaizip command syntax, flags, aliases, and component selection
- [Configuration reference](/en/docs/reference/config.md): thaizip.config.json v4, component styles, and project detection rules
