dealplustech-astro/AGENTS.md

dealplustech-astro/

Generated: 2026-03-27 Branch: main

OVERVIEW

Astro 5.x Thai industrial e-commerce site (dealplustech.co.th). Migrated from WordPress. PDPA-compliant cookie consent, Umami analytics, 63 pages, 45 Thai-named routes.

STRUCTURE

dealplustech-astro/
├── src/
│   ├── components/     # .astro components (common/, consent/, product/, ui/)
│   ├── content/        # Astro content collections (blog/, products/) - EMPTY
│   ├── layouts/        # BaseLayout.astro (root HTML shell)
│   ├── pages/          # 45 Thai-named static routes + index.astro
│   ├── styles/         # global.css
│   ├── images/         # ppr-tables/ (product reference images)
│   └── lib/            # EMPTY
├── public/
│   ├── images/         # All product/corporate images (dist/, public/ mirrored)
│   └── documents/      # PDF price lists (11 PDFs linked from product pages)
├── db/                 # EMPTY (SQLite/Turso for consent logs at runtime)
├── astro.config.mjs    # Astro config: site URL, i18n (th only), sitemap
├── tailwind.config.js  # Kanit font, custom colors (primary green, accent orange)
├── Dockerfile          # Multi-stage: node:20-alpine → nginx:alpine
└── package.json        # Scripts: dev, build, preview, db:push, db:seed

WHERE TO LOOK

Task	Location	Notes
Global layout	src/layouts/BaseLayout.astro	HTML shell, SEO meta, cookie consent
Homepage	src/pages/index.astro	13KB - main entry
Product pages	src/pages/[thai-url]/index.astro	45 static routes
Header/Footer	src/components/common/	Header.astro, Footer.astro
Cookie consent	src/components/consent/	EMPTY - handled via astro-consent
API routes	src/pages/api/	EMPTY - no API routes configured
Content config	src/content.config.ts	Content collections definition

CONVENTIONS

• Thai URLs only — Never use English URLs for routes
• Astro components — .astro files with frontmatter imports
• Kanit font — Thai-optimized, set in tailwind.config.js
• Cookie consent — astro-consent package, blocks analytics until accepted
• Umami analytics — Requires UMAMI_WEBSITE_ID env var
• Admin password — Required for consent log access at /admin/consent-logs

ANTI-PATTERNS (THIS PROJECT)

• Do NOT add TypeScript entry points (no src/main.ts)
• Do NOT use English route names — SEO depends on Thai URLs
• Do NOT modify dist/ directly — it's gitignored build output
• Do NOT run crawlers from Python in production environment
• Do NOT commit .env files

UNIQUE STYLES

• Custom Tailwind colors: primary (green #3f8b6d), accent (orange #e35c18)
• PDPA compliance: 14-disclosure privacy policy, granular cookie consent
• Custom animations: fade-in, slide-up, slide-down, scale-in
• i18n: Thai-only site, prefixDefaultLocale: false
• Image organization: Mirrored public/images/ and dist/images/

COMMANDS

cd dealplustech-astro

npm install          # Install dependencies
npm run dev          # Dev server at localhost:4321
npm run build        # Production build → dist/
npm run preview      # Preview built site

# Database
npm run db:push      # Push schema to SQLite/Turso
npm run db:seed      # Seed database

NOTES

• No tests — package.json has no test script
• Easypanel deploy — Auto-deploys on push to main, uses npm install then npm run build
• Image pipeline — Python image_processor.py processes downloaded images
• Consent logs — SQLite at db/consent.db (gitignored), or Turso if configured
• PDF price lists — 11 PDFs in public/documents/, linked from 7 product pages with "ราคาสินค้า" section