Migration Summary

Status

A maintainable Astro migration and substantial fidelity-first pass are implemented. The live public site was used as the authority for the shared shell, English and Spanish homepages, service-page family, team page, library indexes, and blog-post family.

Migrated Content and Assets

46 English, 12 Spanish, and 7 Arabic library posts.
21 English, 9 Spanish, and 2 Arabic page records.
One author record per language.
167 self-hosted images, 20 font files, and two PDF downloads.
Current June and May 2026 English library articles are included.

HubSpot-generated wrappers, analytics, scripts, CSS, query-language duplicates, AMP variants, pagination, and author archive variants are not carried into the Astro implementation.

Live-Source Fidelity Pass

Live pages inspected during the pass include:

English and Spanish homepages
ABA Therapy, Autism Evaluations, and Learner Social Club
About, Team, Client Consultation, and Giveback & Donate
English and Arabic Library indexes
Representative current library articles

Implemented fidelity work includes:

Rebuilt the live two-tier header, navigation hierarchy, language controls, utility links, footer columns, and contact information.
Rebuilt the complete English and Spanish homepages in their live section order using one reusable Astro component and self-hosted source assets.
Moved the English and Spanish homepage copy into section-oriented home: frontmatter blocks so the page is easier to edit in Front Matter CMS.
Rebuilt service pages around the live compact title banner and editorial presentation, with current visible headings and working calls to action.
Recovered and restored the live decorative hero imagery for all mapped English and Spanish page routes plus every language's library index.
Restored the consultation form section's injected background image.
Added a dedicated live-derived team card grid rather than presenting the extracted team content as a generic article.
Rebuilt the contact page around the live two-column content/form section and full-width Leaflet map while retaining local clickable obfuscated phone links.
Rebuilt the giveback page as four source-faithful full-width sections with its original image/copy proportions, fundraiser color band, nonprofit logo, emphasis, and external donation calls to action.
Rebuilt library indexes and blog-post presentation around the live sidebar, article list, byline, featured-image, and counter patterns.
Converted FAQ-bearing posts to MDX and routed their accordions, the standalone FAQ page, and the insurance FAQ through one reusable component. Each accordion uses the same animated, single-open interaction and a component-scoped caret color override; blog and insurance instances also emit matching FAQPage JSON-LD.
Restored 32 live-source blog blockquotes with their original emphasis, links, fawn backgrounds, spacing, rounded presentation, and quote-mark SVG.
Replaced generic oversized cards, rounded controls, and marketing heroes with live-derived typography, palette, widths, spacing, and compact controls.
Corrected material live-source discrepancies found during the pass, including current homepage ESA copy, testimonial content, and ABA copy.

Intentional visual deviations

The homepage and /insurance carrier-logo rows intentionally share one responsive layout. The first and last logos sit flush with the row edges, and the Blue Cross Blue Shield mark is emphasized at 125% of the standard desktop logo width, following its treatment on the live homepage rather than preserving the live pages' differing row spacing.
The Community 4 Autism logo on /donate-autism-giveback is horizontally centered on mobile instead of retaining the live page's left alignment.
The empty <h6> retained by the live /schedule-consultation page was removed. It had no visible content and generated an empty heading ID in the migrated Markdown, so omitting it improves heading semantics and fragment integrity without removing page content.

URLs and Redirects

Clean public URLs are preserved, including:

/aba-therapy
/autism-evaluations
/learner-social-club
/client-consultation
/library
/library/post-slug
available /es/... and /ar/library/... routes

The generated sitemap contains 97 canonical URLs. Nginx rewrites exist only for the brief aliases /aba, /autismevaluations, and /learnersocialclub.

Forms

Visible consultation/contact-style pages render styled static HTML forms with backend and spam-protection TODO comments. Submission is intentionally disabled. Appointment and enrollment calls to action route to the static consultation page rather than retaining the production Jotform backend.

The three English service pages also reproduce the live site's delayed, right-edge inquiry drawers, including their page-specific enrollment copy, shared field set, modal overlay, and responsive layout. These drawer forms are static and their submit controls remain disabled until a production backend and spam protection are selected; this is an intentional functional and visual deviation from the live HubSpot form.

External Dependencies

The contact page map intentionally matches the live Leaflet/OpenStreetMap implementation and loads Leaflet from unpkg.com plus map tiles from tile.openstreetmap.org.

Multilingual

Spanish has the full live-derived homepage, translated service pages, library index, and available translated posts.
Arabic has RTL support, a clearly marked placeholder landing page, the live library family, and available Arabic posts.
Language-switcher choices are emitted only when the corresponding Astro route exists, preventing dead translated-route links.
Arabic pages use lang="ar" and dir="rtl"; English and Spanish use LTR.
No large Arabic translations were invented.

Likes and Views

The post counter uses PUBLIC_AIA_API_BASE, defaulting to https://api.azinstitute4autism.com. Its contract was verified against the current live-site script:

POST /stats/batch for likes and views
POST /likes to like
DELETE /likes/{slug} to unlike

It preserves cookie-backed liked state and degrades gracefully if the API is unavailable.

SEO and Accessibility

Canonicals, Open Graph tags, Twitter card tags, semantic titles, and global organization JSON-LD are emitted by shared layouts.
Organization JSON-LD intentionally omits raw telephone and email fields; visible contact details use the Astro obfuscation component to avoid exposing plain email and phone targets in rendered HTML.
Library-index canonicals and current visible page H1s are explicitly set.
Extracted image alt text is retained where available.
Semantic landmarks, skip link, labeled forms, keyboard-operable navigation, language/direction attributes, and responsive layouts are present.
Sätteri heading attributes are enabled for Markdown and MDX, allowing stable explicit fragment IDs such as {#accepted-insurance-heading}. The built-site audit found no duplicate or invalid IDs and no missing same-page fragments.
Sätteri directive parsing is enabled. No named directive transformations are registered yet, so unhandled directives must not be added to published content until their semantic HTML rendering is defined.

Validation Results

npm audit --offline: passed with zero known vulnerabilities under Node 24.18.0; flake.nix provides a compatible current Node release.
npm run audit:links: passed with zero broken internal source links. The audit now checks generated routes, root-relative references, relative Markdown links, and public assets when rendered output is unavailable.
npm run audit:images: passed with no missing mapped page banners, section backgrounds, or blog featured images.
npm run audit:blog: passed with no article-header content duplicated in blog content and valid MDX FAQ components for 125 questions across 19 posts.
npm run generate:sitemap: passed; generated 97 URLs.
npm run generate:redirects: passed.
All migration .mjs tools and the sandbox DNS helper pass node --check.
The Astro compiler parsed all 49 .astro files successfully.
npm run build: passed with zero Astro diagnostics and generated 97 static pages.
npm run build:sandbox: passed; generated 97 static pages.
Live contact-page structure was inspected in browser at a 1280px desktop viewport; local generated HTML was checked for the contact layout, Leaflet assets, map container, and obfuscated clickable phone script. Local browser rendering was blocked because the Playwright browser cannot reach shell loopback servers and blocks file: URLs in this environment.
Nix shell verification and npm audit retrieval were blocked by sandbox proxy/cache network resets.

Manual Review

Perform full-page desktop and mobile visual comparisons for page-specific layouts beyond the completed homepage, team, service, library, and article families.
Editorially review extracted long-form content for remaining extraction artifacts, stale phone/email references, and heading hierarchy.
Review all source alt text, keyboard behavior, screen-reader output, and contrast with accessibility tooling.
Have fluent reviewers approve Spanish content and Arabic RTL presentation.
Select and connect a form backend with spam protection before launch.
Validate like/view CORS, credentials, and production behavior after deployment.

9.4 KiB Raw Blame History