fossui

An open-source Flutter UI library of themeable, accessible components, inspired by coss.com/ui, Cal.com's design system. Themed from one source, one import.

Status: beta, under active development. This pre-release (0.1.0-beta.2) ships 21 components, but APIs and tokens can still change between releases. Pin an exact version if you depend on it.

Unofficial. Not affiliated with or endorsed by Cal.com, Inc. or coss.com. See NOTICE for attribution.

Install

dependencies:
  fossui: ^0.1.0-beta.2

Usage

Register the theme once, then read tokens through context.fossTheme. There is no FossApp wrapper; the library works under MaterialApp, CupertinoApp, or a bare WidgetsApp.

import 'package:flutter/material.dart';
import 'package:fossui/fossui.dart';

void main() => runApp(
      MaterialApp(
        theme: FossThemeData.light.toThemeData(),
        darkTheme: FossThemeData.dark.toThemeData(),
        home: const Scaffold(
          body: Center(child: FossBadge(label: Text('fossui'))),
        ),
      ),
    );

See example/ for a runnable app. Components and theming are added in tiers. See the components roadmap for what is shipped and what is planned, the component checklist for the bar each one clears, and CHANGELOG.md for released versions.

Links

• Documentation: fossui.org
• Live gallery: play.fossui.org
• Package: pub.dev/packages/fossui

Platforms

Built on package:flutter/widgets.dart with no platform channels, so it runs anywhere Flutter does. During the beta, mobile is the tested target:

Platform	Status
iOS, Android	Tested and supported.
Web, macOS, Windows, Linux	Should work, not yet verified. Use with care.

Development

This package pins its Flutter SDK with fvm:

fvm install          # uses .fvmrc (Flutter 3.41.9)
fvm flutter pub get
fvm flutter test

Contributions are welcome. See CONTRIBUTING.md for the workflow and the Code of Conduct.

License

MIT. See LICENSE and NOTICE.

Star History