Fidus Design System

A privacy-first, AI-driven component library for building contextual user experiences

What is Fidus Design System?

Fidus Design System is a comprehensive collection of reusable components, patterns, and guidelines for building the Fidus personal assistant application. It embodies our core principles of privacy, user control, and context-aware interactions.

Unlike traditional design systems, Fidus embraces an AI-Driven UI paradigm where the interface adapts to user context, intent, and expertise level. Components are designed to be flexible and composable, supporting multiple presentation modes determined at runtime.

Key Principles

Privacy-First Design

Every component and pattern prioritizes user privacy. Data stays on device when possible, encryption is the default, and users have complete control over their information.

AI-Driven UI

The UI adapts to context rather than following predetermined flows. The same user query can produce different interfaces based on time, location, user expertise, and intent.

User Control

Users explicitly control their experience. No auto-hiding elements, no forced workflows. Every action requires user consent, and dismissal is always available.

Context-Aware Components

Components understand their context and adapt their behavior accordingly. A calendar widget can appear in chat, as a dashboard card, or in a dedicated view based on user needs.

Component Categories

Layout

Structural components for organizing content

View Layout Components →

Forms

Input components with validation and accessibility

View Form Components →

Data Display

Components for presenting information

View Data Components →

Feedback

Alert, toast, and progress indicators

View Feedback Components →

Quick Start

For Developers

Install the component library and start building:

npm install @fidus/ui
Full Developer Guide →

For Designers

Learn about design principles and component anatomy:

Full Designer Guide →

Core Concepts

Opportunity Surface

Rather than fixed dashboards, Fidus presents an Opportunity Surface where relevant cards appear based on user context. The LLM decides what to show, users control dismissal.

Learn more about our philosophy →

Dynamic Forms

Forms adapt to user expertise. Beginners get wizards, experts get quick-entry forms, and everyone can use conversational input.

View form patterns →

Context-Aware Rendering

Components receive context and adapt their presentation. A budget widget might show a warning in morning planning sessions but a simple progress bar during the day.

Read about AI-Driven UI →

Next Steps

Contributing

Fidus Design System is open for community contributions. Whether you are fixing bugs, adding components, or improving documentation, we welcome your input.

Read the Contributing Guide →