Guides and references for Parcelry

Documentation Topics

• Quick start

  Get Parcelry running locally, switch brands, and understand the core workflow in five minutes.

  Start developing or evaluating Parcelry locally with Node 20+, run the dev server, and test the multi-brand workflow.

• Install & build

  How to install dependencies, run tests, build static outputs for both brands, and preview the production bundles.

  Commands and lifecycle scripts for building Parcelry for production.

• Deploy

  Deploy Parcelry to Cloudflare Pages, Netlify, or Vercel with zero server configuration.

  Step-by-step instructions for deploying static output to popular Jamstack and edge hosting providers.

• Brands & tokens

  How the multi-brand architecture works, how tokens are structured, and how to add a third brand.

  Every brand is pure data in src/content/brands/<brand>/. The component tree is 100% shared.

• Content (content.json)

  Customising headlines, navigation labels, button microcopy, and page content.

  All buyer-facing copy lives in content.json and pages.json, separated from layout and logic.

• Data files

  Managing shipments.json and cities.json, and running the route validator.

  Shipment datasets follow strict geographic and state progression rules (E1-E6).

• Forms

  How demo forms work and how to connect Formspree, Netlify Forms, or a custom endpoint.

  Quote, Careers, and Contact forms use a pluggable adapter architecture.

• Remove demo tools

  How to remove the floating brand switcher pill, sample labels, and fictional data for client delivery.

  Follow these steps to convert the demo template into a production client build.

• Accessibility

  Accessibility standards, ARIA roles, contrast guarantees, and keyboard navigation.

  Built to satisfy WCAG 2.1 AA and AAA requirements with zero automated a11y violations.

• Performance

  Page budgets, asset pruning, zero UI framework overhead, and Core Web Vitals targets.

  Engineered for instant loads, minimal transfer, and zero runtime layout shifts.

• Browser support

  Supported desktop and mobile browsers, CSS feature usage, and fallbacks.

  Targeted at all modern evergreen browsers with graceful degradation for older clients.

• Upgrading

  Upgrading Astro, dependencies, and maintaining multi-brand compatibility.

  Guidelines for keeping your Parcelry installation updated over time.

• Troubleshooting

  Common build, validation, and layout issues and how to resolve them.

  Quick solutions to common problems during setup and development.

• Credits & licenses

  Third-party libraries, photography credits, fonts, and licensing details.

  Full disclosure of all open-source libraries and royalty-free assets used in Parcelry.