Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

2.7 KB
Raw Blame
import 'package:harness/shared/theme/app_icons.dart';
import 'package:flutter/material.dart';

import '../theme/app_theme.dart';

/// "There's nothing here (yet)."
///
/// The app grew at least fourteen private one-off versions of this — `_Empty`
/// four times, `_NoAgent` three, plus `_NoJobs`, `_NoResults`, `_NoMatches`,
/// `_NoMatch`, `_NoGrid`, `_NoSelection`, `_NothingServedYet`, `_NoModelYet`.
/// Same idea every time, all `_`-private, so none could be reused and each drew
/// its icon at a different size.
///
/// Two flavours worth keeping distinct:
///  - *nothing exists yet* → give the user the action that creates the first one
///    ([action]).
///  - *nothing matches the filter* → no action; the fix is to change the query.
class EmptyState extends StatelessWidget {
  const EmptyState({
    super.key,
    required this.icon,
    required this.title,
    this.message,
    this.action,
    this.compact = false,
  });

  final IconData icon;
  final String title;

  /// One quiet line under the title. Keep it to a sentence.
  final String? message;

  /// The action that makes the emptiness go away — "New agent", "Add plugin".
  final Widget? action;

  /// Tightens the spacing for an empty state inside a card or a narrow column
  /// rather than a whole pane.
  final bool compact;

  /// Nothing matched the current search or filter. Deliberately actionless.
  const EmptyState.noMatches({super.key, this.message, this.compact = true})
    : icon = AppIcons.searchX,
      title = 'No matches',
      action = null;

  @override
  Widget build(BuildContext context) {
    AppTheme.watch(context);
    return Center(
      child: Padding(
        padding: EdgeInsets.all(compact ? 16 : 32),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          mainAxisSize: MainAxisSize.min,
          children: [
            Icon(icon, size: compact ? 24 : 32, color: AppPalette.textFaint),
            SizedBox(height: compact ? 10 : 14),
            Text(
              title,
              textAlign: TextAlign.center,
              style: AppType.heading(color: AppPalette.textPrimary),
            ),
            if (message != null) ...[
              const SizedBox(height: 6),
              ConstrainedBox(
                constraints: const BoxConstraints(maxWidth: 320),
                child: Text(
                  message!,
                  textAlign: TextAlign.center,
                  style: AppType.body(
                    color: AppPalette.textSecondary,
                    height: 1.4,
                  ),
                ),
              ),
            ],
            if (action != null) ...[
              SizedBox(height: compact ? 12 : 18),
              action!,
            ],
          ],
        ),
      ),
    );
  }
}