Naluma WordPress

Naluma is an evidence-based tinnitus information platform for patients and caregivers. This repository contains the marketing website and headless CMS that serves both the web frontend and the Naluma Flutter mobile app.

Tech Stack

Component	Technology
CMS	WordPress 6.9 on Bedrock
Language	PHP 8.1+
Database	MariaDB 10.6
Dependencies	Composer 2.x, npm
Local development	Docker Compose (OrbStack or Docker Desktop)
Theme	Full Site Editing block theme (naluma-theme)
Hosting	Kinsta (production + staging)

The site publishes content through three custom post types (Article, Research Summary, Landing Page) and exposes it via a custom REST API under /tinnitus/v1/. Content is managed in German and English using Polylang Pro.

Documentation Sections

Getting Started --- Install prerequisites, set up the local environment, and verify everything works.

How-To Guides --- Step-by-step instructions for common tasks: deploying, adding mu-plugins, creating blocks, registering content types, and managing translations.

Reference --- Lookup tables for commands, plugins, mu-plugins, content types, ACF fields, REST API endpoints, environment variables, and coding standards.

Explanation --- Deeper discussion of architecture decisions, the content model, security hardening, performance strategy, and FSE CSS patterns.

Quick Start

If you want to get running immediately:

git clone git@github.com:Tinnitus-App/tinnitus-wordpress.git
cd tinnitus-wordpress
./scripts/setup.sh

Then open http://localhost:8080. For the full walkthrough, start with Prerequisites.