Terra - Headless Real Estate (WordPress + Next.js)

The problem

Real estate clients want to manage their own listings, and WordPress is the admin they already understand. But a classic WP theme ties presentation to PHP templates and to whatever the host can serve. The goal was to keep wp-admin as the editing surface while the public site becomes a fast, statically rendered app, in two languages, without the CMS ever being the thing visitors load.

Approach

• WordPress runs as a headless CMS with custom post types for listings and neighborhoods, exposed through WPGraphQL.
• Polylang keeps English and Portuguese content in parallel, and the front end resolves the right translation per route.
• The Next.js front end renders static pages with incremental revalidation, so editors publish in wp-admin and the public site picks the change up on its own.
• Listings are filtered by type, status and neighborhood, and each property is placed on OpenStreetMap tiles rather than a paid map provider.
• The demo data seeds from inside wp-admin instead of requiring WP-CLI, so the project stays deployable on ordinary shared hosting.

What it proves

• Live front end on Vercel with the WordPress CMS running on its own subdomain.
• 112 tests covering the GraphQL layer, filtering and translation resolution.
• Verified against production, including the bilingual routes and the map rendering.