Migrate from WordPress to Astro in Florence
Many businesses in Florence run WordPress but face performance ceilings, security overhead, and rising hosting costs. Astro solves these with static HTML output, zero JavaScript by default, and edge deployment. I migrate existing WordPress sites to Astro with full SEO preservation, URL mapping, and 301 redirects.
- PageSpeed 95-100
Static HTML with zero JavaScript. Faster than any WordPress solution.
- SEO-safe migration
URL mapping, 301 redirects, Google rankings preserved.
- Cloudflare Pages hosting
Global CDN, free SSL, instant deployments. Hosting costs near zero.
Luxury fashion houses along Via de' Tornabuoni, leather goods manufacturers in the Scandicci and Osmannoro industrial districts, and boutique hospitality and cultural operators across the Metropolitan City of Florence face a persistent technical conflict: their digital platforms must present uncompressed visual editorial quality while still passing Google's Core Web Vitals thresholds on mobile connections. I am Mariusz Szatkowski, an independent software developer based in Gdynia, Poland. Working 100% remotely and asynchronously in writing, I engineer Astro 5 web architectures for Florentine brands, exporters, and SaaS teams that want zero-JavaScript static speed paired with isolated interactive islands.
Why Florentine Luxury, Manufacturing, and Cultural Platforms Move to Astro 5
Florence’s digital economy spans three distinct sectors that outgrow monolithic templates and JavaScript-heavy Single Page Applications (SPAs):
- Leather Goods, Footwear, and Textile Supply Chains (Scandicci, Sesto Fiorentino, Osmannoro, and the neighboring Prato textile cluster): Suppliers and brand owners exhibiting at Pitti Immagine inside the Fortezza da Basso publish seasonal lookbooks, B2B buyer portals, and multi-market D2C catalogs in Italian, English, French, German, Japanese, and Korean. When built as full-page React or Vue bundles, these image-dense catalogs ship hundreds of kilobytes of hydration JavaScript before the browser even paints the hero photograph.
- Cultural Institutions, Museums, and Boutique Hospitality (Centro Storico, Oltrarno, Fiesole): Ticketing portals, exhibition calendars, and luxury hotel booking frontends experience sharp traffic spikes from international visitors on roaming mobile connections. Every unnecessary script directly degrades Largest Contentful Paint (LCP) and Interaction to Next Paint (INP), reducing direct booking conversion against OTA aggregators.
- Digital Product Studios and SaaS Scale-ups (Nana Bianca ecosystem, Manifattura Tabacchi, Sant’Ambrogio): Florentine software teams building marketing sites, technical documentation, and multi-tenant content hubs need a frontend architecture that separates content publishing from application state.
Astro 5 resolves this bottleneck by rendering routes to clean, semantic HTML at build time (or on the edge) and stripping all framework JavaScript from the client bundle unless a specific component is explicitly marked with a client:* directive.
| Architectural Dimension | Monolithic SPA / Heavy React Stack | Astro 5 Island Architecture |
|---|---|---|
| Default Client JavaScript | Full framework runtime + router + state hydrated on every page (300 KB+ gzipped) | 0 KB by default; JS loads only inside isolated interactive islands |
| Editorial & Lookbook Media | Client-side image components often delayed by hydration waterfalls | Build-time astro:assets generating AVIF/WebP srcset and native priority hints |
Core Web Vitals Targets (web.dev) | Frequent INP regressions above 200 ms on mobile devices during scroll/filter | Engineered to meet LCP up to 2.5 s, INP up to 200 ms, CLS up to 0.1 |
| Multilingual International SEO | Complex middleware and dynamic route hydration overhead | Deterministic static i18n routing (it, en, fr, de, ja) with automatic hreflang |
| CMS & Commerce Coupling | Tight coupling to a single backend or heavy client-side GraphQL client | Content Layer API unifies headless WordPress, Storyblok, Sanity, or Shopify |
Astro 5 Engineering for High-Resolution Visuals and Headless Commerce
When a Florentine fashion brand or industrial manufacturer commissions an Astro build, my engineering focus centers on media pipeline determinism, typed content schemas, and isolated commerce interactivity.
1. The astro:assets Pipeline for Editorial Lookbooks and Material Catalogs
Fashion and architectural photography cannot suffer from compression artifacts or cumulative layout shift. In Astro 5, I configure <Image /> and <Picture /> components backed by Sharp at build time or Cloudflare/Vercel image transformation endpoints:
- Multi-format negotiation: Every master asset from your studio is compiled into
AVIFandWebPformats across device-specific breakpoints (400w,800w,1280w,1920w,2560w) while preserving color profiles (sRGB/Display P3) critical for leather grain and fabric tone accuracy. - Zero layout shift (
CLS up to 0.1): Aspect-ratio bounding boxes and intrinsicwidthandheightattributes are baked directly into the static HTML before a single byte of image data arrives over the network. - Above-the-fold priority: Hero editorial frames receive
loading="eager",decoding="async", andfetchpriority="high"with matching<link rel="preload" as="image">headers, while offscreen lookbook galleries use native lazy loading.
2. Astro Islands (client:load, client:visible, client:idle) for D2C and B2B Carts
An entire page does not need to be a React application just because it contains a size selector, a leather swatch configurator, or a sliding shopping bag:
---
// src/pages/[lang]/collections/[slug].astro
import BaseLayout from '../../../layouts/BaseLayout.astro';
import { Picture } from 'astro:assets';
import SwatchConfigurator from '../../../components/islands/SwatchConfigurator.tsx';
import QuickReserveDrawer from '../../../components/islands/QuickReserveDrawer.svelte';
import { getCollectionEntry } from '../../../lib/content-layer';
const { lang, slug } = Astro.params;
const item = await getCollectionEntry('lookbook', `${lang}/${slug}`);
---
<BaseLayout title={item.seoTitle} description={item.seoDescription} lang={lang}>
<article class="editorial-spread">
<Picture
src={item.heroImage}
formats={['avif', 'webp']}
widths={[640, 1024, 1600, 2400]}
sizes="(max-width: 1024px) 100vw, 65vw"
alt={item.heroAlt}
loading="eager"
fetchpriority="high"
/>
<div class="product-meta">
<h1>{item.title}</h1>
<p class="sku-ref">Art. {item.articleCode} · Crafted in Scandicci, Firenze</p>
<!-- Hydrates only when scrolled into viewport -->
<SwatchConfigurator client:visible variants={item.leatherVariants} />
<!-- Hydrates when browser main thread is idle -->
<QuickReserveDrawer client:idle sku={item.articleCode} locale={lang} />
</div>
</article>
</BaseLayout>3. Server Islands (server:defer) for Real-Time Stock, Pricing, and Ticketing
Introduced and refined in the Astro 5 lifecycle, Server Islands allow static HTML shells to be cached globally at the CDN edge while deferring personalized or real-time fragments (such as live museum time-slot availability, regional B2B wholesale tier pricing, or Scandicci warehouse stock counts) to an asynchronous server render. The visitor receives the complete editorial page immediately, and the dynamic slot streams in without blocking First Contentful Paint.
4. Headless CMS and Italian Payment / ERP Integrations
Using Astro’s Content Layer API with Zod schema validation (src/content.config.ts), I connect your static frontend to whichever content or commerce backend fits your operations:
- Editorial & Catalog CMS: Headless WordPress (WPGraphQL / REST API), Storyblok, Sanity, Directus, or Keystatic.Teams already active in the local WordPress Firenze Community often keep WordPress as their familiar editorial back office while replacing slow PHP theme rendering with an Astro 5 static frontend.
- Commerce & Italian Payment Gateways: Shopify Storefront API, WooCommerce Store API, Stripe, Nexi (XPay), Satispay, and Scalapay.
- Italian Invoicing & ERP Workflows: Checkout islands validate Italian tax fields (Codice Fiscale, 11-digit Partita IVA, 7-character Codice Destinatario SDI, or PEC address) so backend order webhooks pass clean payloads to TeamSystem, Zucchetti, SAP Business One, or Fatture in Cloud for automated Fatturazione Elettronica via the Sistema di Interscambio (SDI) of the Agenzia delle Entrate.
Italian Statutory Compliance Engineered into the Astro Build
Building for an Italian company registered in the Province of Florence requires strict adherence to national statutory acts and supervisory rulings. I bake these requirements directly into the layout components and build gates rather than relying on fragile third-party widgets.
1. Garante per la protezione dei dati personali Cookie Guidelines (Provvedimento 10 giugno 2021)
The Italian Data Protection Authority (Garante Privacy), operating under the GDPR and the Italian Privacy Code (D.Lgs. 196/2003 as amended by D.Lgs. 101/2018), enforces strict technical rules on cookies and tracking tools (Linee guida cookie e altri strumenti di tracciamento, doc. web n. 9677876):
- Zero pre-consent execution: Because Astro ships zero client-side JavaScript by default, analytics, Meta Pixel, or remarketing scripts are never bundled into the initial HTML payload.
- Compliant banner mechanics: The consent island includes the mandatory top-right
Xclosure button with explicit text stating that closing the banner continues navigation without non-technical tracking cookies, equal visual prominence between accept and reject controls, and no scroll-based consent (scrolling alone is never treated as valid opt-in). - Consent state persistence: User preferences are stored with verifiable timestamps and minimum 6-month re-prompt intervals unless processing conditions change.
2. Legge Stanca (Legge 9 gennaio 2004, n. 4) and the European Accessibility Act (D.Lgs. 27 maggio 2022, n. 82)
Under Italy’s Legge Stanca and Decreto Legislativo 82/2022 (transposing Directive EU 2019/882, supervised by AgID, Agenzia per l’Italia Digitale), private enterprises offering e-commerce, ticketing, and digital consumer services must conform to WCAG 2.1 Level AA (EN 301 549) and publish a formal Dichiarazione di Accessibilità:
- Semantic landmark hierarchy (
<header>,<main>,<nav>,<aside>,<footer>), deterministic heading levels, and programmatic form error associations (aria-describedby,aria-invalid). - Full keyboard operability (
Tab,Shift+Tab,Escape) and focus-trap management inside interactive Astro islands (such as lookbook lightboxes, language switchers, and cart drawers). - Respect for
prefers-reduced-motion: reduceacross all Astro<ClientRouter />View Transitions so motion-sensitive users never face forced parallax or slide animations.
3. Mandatory Corporate Disclosures (Art. 2250 Codice Civile & D.Lgs. 70/2003)
Italian commercial law (Art. 2250 c.c. and Art. 7 D.Lgs. 70/2003 on electronic commerce) penalizes companies that omit statutory corporate identifiers from their website templates. Every global Astro footer component I build for a Florentine S.r.l. or S.p.A. exposes structured, crawlable fields for:
- Full corporate denomination (Ragione Sociale) and registered office (Sede Legale in Firenze, Scandicci, Sesto Fiorentino, Prato, or Campi Bisenzio).
- Partita IVA / Codice Fiscale and registration number at the Registro delle Imprese di Firenze (Camera di Commercio di Firenze) alongside the REA (Repertorio Economico Amministrativo, prefix
FI-XXXXXX). - Fully paid-up share capital (Capitale Sociale i.v.), sole shareholder status (Socio Unico) or control and coordination declarations (Direzione e Coordinamento under Art. 2497-bis c.c.) where applicable, plus the company’s PEC (Posta Elettronica Certificata) address.
How We Work Together: Direct, Written, Asynchronous Engineering
I operate as a solo software developer in Gdynia, Poland. When you hire me for an Astro project, you work directly with the engineer writing your code:
- 100% written communication: I do not hold phone calls, Zoom/Teams video meetings, or live synchronous workshops. All architecture proposals, milestone updates, pull request walkthroughs, and edge-case decisions are documented clearly in writing (in English). For every Florence and Scandicci engineering thread, I reply in writing on working days.
- Why written collaboration works for Florentine teams: Creative directors in Florence and production managers in Scandicci do not lose half-days to status calls. Every technical decision is recorded in GitHub issues or written briefs that your in-house developers or external SEO specialists can reference months later.
- Design handoff boundaries: I do not create brand identities, photography, or graphic UI designs. Your team or external Italian creative studio provides the Figma design files, and I implement them into pixel-accurate, accessible Astro 5 components.
- Clean repository ownership: All code is delivered in a structured Git repository with automated CI gates (TypeScript
astro check, broken-link verification, schema validation, and Playwright smoke tests) deployable to Cloudflare Pages, Vercel, AWS CloudFront, or European bare-metal infrastructure.
Architectural Blueprint: Migrating a Florentine Lookbook & B2B Catalog to Astro 5
When a fashion label in Centro Storico or a leather manufacturer in Scandicci transitions from a monolithic CMS or a heavy React SPA to Astro 5, the engineering work follows a structured four-stage blueprint:
| Migration Stage | Engineering Deliverable | Verification Gate |
|---|---|---|
| 1. Schema & Content Layer Design | Define typed Zod collections in src/content.config.ts for seasonal collections, leather/textile material cards, showroom locations, and localized it, en, fr, de, ja copy. | astro check + zero schema validation errors across all locales. |
2. Visual & Media Pipeline (astro:assets) | Configure Sharp build-time transforms generating AVIF and WebP srcset variants (400w to 2560w) with preserved color profiles and explicit aspect-ratio containers. | CLS up to 0.1 and LCP up to 2.5 s on mobile emulation. |
| 3. Surgical Island Hydration | Isolate swatch selectors, B2B showroom appointment drawers, and Shopify/WooCommerce/Nexi checkout triggers into client:visible or client:idle islands; move live stock to server:defer. | 0 KB framework JS on pure editorial lookbook routes; INP up to 200 ms. |
| 4. Italian Statutory & SEO Hardening | Embed Garante Privacy (10 June 2021) consent logic with top-right X dismissal, Legge Stanca (Legge 4/2004 & D.Lgs. 82/2022) WCAG 2.1 AA landmarks, and Art. 2250 c.c. Registro delle Imprese di Firenze (REA FI) footer disclosures. | Automated axe-core accessibility check + reciprocal hreflang and JSON-LD audit. |
Handling Seasonal Pitti Immagine Traffic Spikes Without Origin Database Load
During Pitti Uomo, Pitti Bimbo, and Pitti Filati at the Fortezza da Basso, international buyers, press editors, and wholesale distributors scan QR codes on physical sample tags to pull up digital line sheets and material specifications on mobile networks inside crowded exhibition pavilions. A traditional database-driven site queries PHP/MySQL or a Node origin server on every scan, risking connection pool exhaustion right when commercial buyers are placing orders.
Astro static builds upload pre-rendered routes to a CDN-backed host (for example Cloudflare Pages as described in Astro’s deployment guides). Product specification pages therefore do not call a PHP or Node origin on every page view, which is the usual reason teams adopt static generation for campaign traffic spikes. Wholesale order flows that need authentication can run through Astro Actions without turning every lookbook URL into a dynamic server route.
Preserving Brand Typography and Editorial Art Direction
Florentine luxury houses invest heavily in custom serif and grotesk web fonts, editorial grid proportions, and micro-interactions. In Astro 5, I implement custom font loading strategies (font-display: swap or optional with metric-compatible fallback descriptors size-adjust, ascent-override, and descent-override plus <link rel="preload" as="font" type="font/woff2" crossorigin>) so custom typography renders without invisible text flashes (FOIT) or layout shifts (FOUT). Every layout specification delivered by your creative director in Figma is translated into maintainable, scoped CSS and clean HTML markup that your team owns permanently.
Start Your Astro Project in Writing
If your organization in Florence, Scandicci, Prato, or across Tuscany needs a fast, compliant Astro 5 storefront, editorial lookbook, or headless WordPress migration, send me your project scope, target URLs, and Figma links through the contact form. Once I inspect your Tuscan catalog structure and layout specifications, For every Florence and Scandicci engineering thread, I reply in writing on working days.
Selected projects
Examples of my work.
Airhelp - WordPress Project | WPPoland
AirHelp was founded in 2013 as a start-up and has grown to become the global leader in defending air passenger rights, helping over 13 million people underst...
alextg.pl - WordPress Project | WPPoland
alextg.pl is a WordPress website for a company that helps customers obtain financing. The project focused on clear service presentation, contact flow and stable technical upkeep...
Andergrant.com - Historic Website for Olsztyn's Premier Club (2009)
The andergrant.com project was created in 2009 as a website for the largest club in Olsztyn, utilizing project-specific technical choices of that era including PHP 5, MySQL, jQuery, and Flash multimedia.
WordPress support & development in Florence
Need this service: Astro developer in Florence?
Describe your project by e-mail. I reply within 48 hours.
Describe your projectExplore other WordPress services and knowledge base
WCAG 2.2, BFSG, EAA conformance report and remediation backlog.
CrUX field-data audit with per-template LCP, INP, CLS attribution.
Custom WordPress engineering and architecture.
Clearer structure, messaging, and conversion flow.
Core Web Vitals, caching, and faster delivery.
NIS2 and DORA scope mapping, supplier register, incident runbook.
Related categories
Supporting articles

Germany's Barrierefreiheitsstärkungsgesetz applied from 28 June 2025. It transposes EAA Directive 2019/882 into national law. I unpack how it affects WooCommerce stores in DE and the four plugin failure patterns I see in audits.

WCAG 2.2 was first published as a W3C Recommendation on 2023-10-05; the current published version on www.w3.org/TR/WCAG22/ is dated 2024-12-12. The EU Accessibility Act (Directive 2019/882) applies from 2025-06-28. Germany's Barrierefreiheitsstärkungsgesetz transposes it into federal law on the same date. This article is the implementation map for a WordPress site in 2026.

BFSG and the EU Accessibility Act require a published accessibility statement with a working complaint mechanism, not just a compliant front end. This is a copy-ready template structure mapped to EN 301 549 clauses and WordPress deliverables.