vf-site/README.md
Ruidy 2e9aa1dc31 docs: update project structure and usage in docs
Revamps AGENTS.md and README.md to reflect the new Astro/Tailwind app
structure, replacing legacy Python generator references. Adds details on
locales, route manifest, build/test commands, and contributor
guidelines.
Clarifies folder usage, i18n, forms, analytics, and phase plan. Removes
obsolete instructions and aligns documentation with current development
practices.
2025-09-05 14:35:35 -04:00

1.7 KiB
Raw Blame History

VillaFleurie Website (Astro + Tailwind)

This site is built with Astro and Tailwind, with FR/EN locales. The legacy Python generator remains for reference but is deprecated — new work happens in src/.

Quick Start

  • Requirements: Node 18+, Corepack enabled (pnpm). Then:
    • corepack enable
    • pnpm install
  • Dev server: pnpm dev → open http://localhost:4321/fr/ (root redirects to /fr/).
  • Build: pnpm build → static output in dist/. Preview: pnpm preview.

Structure

  • src/pages/fr|en/: localized pages (Home, Apartments, Reviews, Rates, Contact, Policies).
  • src/layouts/: shared layout with sticky header, language toggle, footer.
  • src/styles/global.css: Tailwind v4 with brand tokens (--color-brand, --color-brand-600).
  • src/i18n/routes.ts: route manifest (hrefFor, siblingPath, navFor).
  • public/: static assets + _redirects (root → /fr/).
  • Spec: docs/spec/website-revamp-spec.md (goals, sitemap, copy, release plan).

i18n & Navigation

  • Folder-based locales with different slugs (e.g., FR avis ↔ EN reviews).
  • Always use the route helpers for links and the language toggle; dont hardcode crosslocale paths.

Forms & Analytics

  • Netlify Forms on /fr/contact/ and /en/contact/, with localized thankyou pages.
  • Plausible events: booking_request_submitted (primary), click_airbnb, click_booking, etc.

Contributing

  • Use Conventional Commits. Include screenshots (FR/EN) for UI changes.
  • Keep the spec updated when requirements change.
  • See AGENTS.md for contributor guidelines and the current phase plan.

👀 Want to learn more?

Feel free to check our documentation or jump into our Discord server.