← Back to projects
Live client product · Headless WordPress and Next.js

Stomagia

A client-operable clinic website, from initial brief to production

Stomagia is a live dental-clinic website built with WordPress as the content and API layer and Next.js as the public frontend.

I owned the documented project scope end to end: information architecture, content and copy, UX/UI, WordPress/PHP and Next.js implementation, integrations, deployment, and production validation. The clinic owner reviewed the medical wording for accuracy before publication.

The delivered system lets authorized clinic staff manage content, publish urgent operational information immediately, review structural changes on Preview, run relevant checks, and promote the approved frontend to Production without requiring GitHub access.

Stomagia production website shown across desktop and mobile layouts
EvidenceLive client product · Public outcome and case-study evidence
ProductPublic website for a dental clinic
UsersProspective patients and authorized clinic staff
OwnershipContent, UX/UI, architecture, implementation, integrations, deployment, and validation
ArchitectureWordPress/PHP CMS and REST APIs · Next.js frontend · GitHub Actions
StatusLive and actively maintained · 2026–present
01

From an initial brief to a complete product

The clinic owner provided an initial service list and medical context. I turned that brief into the information architecture, copy, interface, technical solution, and review-ready content.

Services, team and business information, FAQs, and contact details needed to remain manageable after launch. Google reviews had to reach the frontend without manual CMS duplication, while contact and appointment actions stayed accessible across mobile and desktop.

02

The system I built

WordPress is the CMS and backend API; a separately deployed Next.js application owns the public experience. A custom headless theme defines CMS behavior and protects the intended REST surface.

The CMS/theme, static frontend, reviews API, Playwright framework, GitHub Actions, and Deploy & Test control surface form one delivery system.

Trustindex synchronizes Google reviews, which a small custom API exposes to Next.js instead of duplicating them in the CMS.

System architectureOne CMS, two frontend environments, controlled delivery
01 · UsersAuthorized clinic staff
02 · CMS and APIWordPress CMS
  • Services
  • Team
  • General Info
  • SEO
  • REST APIs
03 · Public applicationNext.js frontend
  • Static site build
04 · Review environmentPreview
  • Manual review
  • Automated checks
05 · Promoted artifactProduction
Release control and validation

Configured actions stay accessible in WordPress while GitHub runs the underlying workflows.

01 · WordPress controlDeploy & Test
02 · AuthenticationGitHub App
03 · AutomationGitHub Actions
04 · ValidationPlaywright + Lighthouse
05 · Returned to WordPressTest summary
Focused repositories

Separately maintained parts of the same delivery system.

stomagia-headlessstomagia-frontendstomagia-at-framework
A high-level view of the CMS, public frontend, delivery controls, validation, and deployment environments.
03

Two proportionate publishing paths

Structural changes follow a reviewable release; urgent operational information can become public immediately.

01

Reviewed structural changes

  1. Edit content in WordPress.
  2. Deploy the generated frontend to Preview.
  3. Review it on preview.stomagia.ro.
  4. Run the relevant automated checks.
  5. Inspect status and evidence in WordPress.
  6. Promote the accepted artifact to Production.
02

Immediate operational updates

Opening hours and temporary announcements update directly from WordPress without a frontend build or deployment.

Release evidence

From content edit to Production

A representative change passes through a visible Preview, review, and validation path before it reaches the live frontend.

  1. 01

    Edit in WordPress

    Clinic content is edited in the CMS, including structured service fields and supporting FAQs.

  2. 02

    Build the Preview

    An authorized editor starts the Preview workflow from Deploy & Test and can follow its status without leaving WordPress.

  3. 03

    Review the result

    The resulting page is checked as a real visitor would see it before the change is accepted for Production.

  4. 04

    Validate and publish

    Test evidence is returned to WordPress, and the accepted frontend can then be promoted to Production.

Immediate updates

No frontend deployment required

Time-sensitive operational information follows a direct path from WordPress to the live frontend.

01

Opening hours

Authorized staff can change the schedule in WordPress and see it reflected immediately in the public navigation.

02

Temporary announcements

A short message can be enabled from the same screen and appears as a prominent banner on the live website.

04

Product and release decisions

The operating model protects reviewed output, keeps routine updates accessible, and holds future content until approval.

01

Promote the reviewed output

Production reuses the successful Preview artifact, so the reviewed version becomes public without a rebuild.

02

Combine judgment with automation

Manual review covers content and presentation; automation covers repeatable behavior such as navigation, contact destinations, API contracts, metadata, and page generation.

03

Keep GitHub out of the clinic workflow

Configured actions, status, test summaries, and audit history are available in WordPress, so authorized clinic staff can operate the website without repository access.

04

Keep future content private by default

The frontend does not request or expose Clinical Cases while the feature is disabled pending approved content and written patient consent.

Prepared capability

Built and validated, but intentionally not public

Clinical Cases is implemented across WordPress and Next.js, including structured content, listings, individual pages, and before-and-after comparisons. It was validated with clearly labelled synthetic content but remains unavailable publicly pending approved material and written patient consent.

  • Implemented
  • Validated with synthetic content
  • Public rollout pending approval and consent
WordPress management and the resulting listing and individual-case interfaces, demonstrated using synthetic content.
05

Designing for patient journeys

The responsive experience begins with what a visitor needs to accomplish.

  • Understand the clinic and its principal services.
  • Move from a service listing to the correct detail page.
  • Use the intended phone, WhatsApp, contact, or appointment action.
  • Find current clinic information on mobile.
  • Navigate comfortably on mobile without hidden or unreachable controls.
  • Continue using the core website when optional external content is unavailable.

Critical CMS data can stop a build that would produce incomplete essential pages; optional integrations such as reviews can degrade without taking down the website.

From service discovery to an appointment action across desktop and mobile.
06

Validation and production checks

Checks run at the smallest reliable layer rather than through one large end-to-end suite.

01

Frontend checks

Linting, type safety, focused unit behavior, and static generation.

02

PHP checks

Theme syntax and public REST-allowlist regression coverage.

03

API checks

CMS settings, services, reviews, response contracts, and feature flags.

04

Playwright UI

Navigation, responsive behavior, search, contact destinations, and public journeys.

05

SEO checks

Canonicals, metadata, JSON-LD, robots rules, and sitemap content.

06

Navigation smoke

Page loads and significant first-party request failures.

07

Lighthouse

Repeated mobile performance, accessibility, and SEO measurements using median results.

08

Post-deploy smoke

WordPress operation after a theme upload.

Allowlisted third-party image failures become warnings; unexpected application and first-party failures remain blocking.

Automated validation

28 / 28 checks passed

Mobile quality budgets

Lighthouse checks passed

Representative Production evidence returned to the WordPress control surface after the configured workflows complete.
07

Outcome

Stomagia is a live, actively maintained client website that clinic staff can operate without direct GitHub access.

The project moved from a small brief to a complete content, interface, and technical system spanning requirements, UX/UI, WordPress/PHP and Next.js implementation, CMS–frontend and reviews integrations, deployment, validation, and ongoing operation.

Live client product

Explore the public patient-facing experience.