Skip to content

Naluma Design System

Naluma is a companion app for people with tinnitus — from the first frightening night to the long road back. The name combines Nada (Sanskrit: primordial sound) and Luma (Tagalog: to settle; luminance). Together: the sound that settles. The sound that becomes light.

This design system is the single source of truth for tokens, brand guidelines, and component specifications shared by the Flutter app and the WordPress marketing site.


Components

Component-level specifications derived from semantic tokens, with platform-specific sizing for app and web.

Buttons | Inputs | Cards | Badges

Integration

How tokens flow into the Flutter app via generated Dart classes and into the WordPress theme via theme.json.

Flutter | WordPress

Accessibility

Tinnitus-specific design principles that go beyond standard WCAG compliance to respect the condition’s unique challenges.

Design Principles


Design tokens are authored as JSON in tokens/ and transformed by Style Dictionary into platform-specific outputs:

OutputPathConsumer
CSS custom propertiesbuild/css/tokens.css, tokens-dark.cssDocumentation site
Dart color classesbuild/flutter/naluma_tokens.dartFlutter app
WordPress theme.jsonbuild/wordpress/theme-tokens.jsonWordPress theme
Flat JSONbuild/json/tokens.jsonTooling, scripts

Run npm run tokens from the repository root to rebuild all outputs.


The sound isn’t going anywhere. But neither are you.

Naluma does not promise silence. It promises the journey in which the sound finds its right place: present, but no longer in front of everything.