Back to resources
Design to codeAgency workflowResourceUpdated March 29, 2026

From design files to WordPress theme: the process I use for agencies.

I take a Figma, PSD or XD file and turn it into a custom WordPress theme that is responsive, performant and ready for handoff. Here is how the process works, phase by phase, and what makes it suitable for agencies delivering to clients.

Design-to-WordPress conversion process

The path from a static mockup to a working WordPress theme follows defined phases. Each phase produces a concrete output, so the agency always knows where things stand and can plan reviews and delivery milestones.

Phase 1 — Design analysis

I thoroughly examine the design files to understand layout structure, component hierarchy, breakpoints, interactive elements, colour scheme and typography. I identify what is feasible in WordPress, what requires custom approaches and what needs adapting for performance and responsive behaviour.

Phase 2 — Technical planning

Before writing code, I define the WordPress architecture: template hierarchy, custom post types, custom fields, plugin scope and responsive strategy. This planning phase prevents rework and keeps delivery predictable for the agency.

It is also the stage where design sensitivity matters most on the development side: an accurate technical analysis here reduces revision cycles later.

Phase 3 — Semantic markup

I create semantic HTML5 markup from the design: proper heading hierarchy, structured content, accessible forms and semantic elements for search engines. This layer is the foundation everything else builds on.

Phase 4 — CSS and responsive

CSS matches the design with high visual fidelity while remaining fully responsive. I use CSS Grid, Flexbox, custom properties and media queries for mobile, tablet and desktop. When the design does not include responsive variants, I create them: rethought layouts for touch, fluid typography, images with srcset and modern formats.

Phase 5 — WordPress integration

I convert HTML into a WordPress theme: functions.php, template tags, The Loop, custom post types, meta fields, widget areas, menus and taxonomies. The theme becomes a cohesive unit living inside the WordPress ecosystem.

Phase 6 — CMS and editable content

I integrate ACF (Advanced Custom Fields) or custom metaboxes to make every content area editable without touching code. The agency's client can update text, images and sections independently. The agency can manage changes without coming back to me for every variation.

Phase 7 — QA, performance and delivery

I test the site on real devices. I optimise Core Web Vitals, lazy loading and caching. I verify WCAG 2.1 AA accessibility: heading hierarchy, alt text, ARIA labels, keyboard navigation and colour contrast. At the end, the theme is production-ready.

Supported design formats

I work with the formats most common in agency workflows.

  • Figma — the most popular, easy to inspect and export assets from.
  • PSD (Photoshop) — classic format, I extract layers and optimise.
  • Adobe XD — similar workflow to Figma, fully supported.
  • Sketch — Mac-native tool, supported without limitations.

What makes an agency-grade build different

An agency build is not just a site that works. It is a product that must survive handoff: moving from my environment to the agency's, then to the end client, without technical surprises.

That means commented and structured code so another developer can continue the project, theme documentation, a CMS configured for non-technical use and no hidden dependencies on non-standard plugins or libraries.

Quality standards

The final result follows the design with high visual fidelity while staying realistic about responsive environments and browser rendering differences. The goal is not fragile perfectionism but a reliable implementation that still feels true to the original design.

Performance first: clean code, minimal dependencies, optimised images, lazy loading. The theme loads fast and ranks well on Core Web Vitals.

WCAG 2.1 AA accessibility: proper heading hierarchy, alt text, ARIA labels, keyboard navigation, sufficient colour contrast and semantic HTML.

What you receive on delivery

Every project includes a deliverable set designed for agencies that need to manage the result independently.

  • Complete custom WordPress theme — production-ready PHP, CSS and JavaScript.
  • Theme documentation — technical guide for developers.
  • CMS setup — instructions for managing content with ACF.
  • 30-day post-launch support — bug fixes and minor adjustments.
  • Git repository — full version history and code access.

Frequently asked questions

How long does a design-to-WordPress conversion take?

It depends on complexity: simple sites (5–10 pages) take 3–4 weeks; medium sites (10–15 pages) 4–5 weeks; complex projects with custom features 6–8 weeks.

Do you work with designs that are not yet responsive?

Yes. If the design does not include mobile and tablet versions, I create them during development, adapting layout, typography and navigation for every viewport.

Does the theme work after handoff without your support?

Yes. The code is structured and documented so another developer or the agency's internal team can step in without depending on me.

Can I reuse the theme for multiple clients?

Each build is custom for the specific project. If reusable foundations are needed, we can agree on a white-label starter theme approach.

Next step

Have a design ready to convert to WordPress?

Share the files and let's figure out how to turn it into a solid WordPress theme, ready for handoff and production.

Discuss the project