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.

feat(desktop): open on a terminal, not on a splash (#271)

Dee757fd992dfc0
diff --git a/desktop/lib/widgets/bootstrapping_screen.dart b/desktop/lib/widgets/bootstrapping_screen.dart
index 2c19aa8b7..014f2bdd9 100644
--- a/desktop/lib/widgets/bootstrapping_screen.dart
+++ b/desktop/lib/widgets/bootstrapping_screen.dart
@@ -1,155 +1,123 @@
import 'package:flutter/material.dart';
import '../shared/theme/app_theme.dart' as grid;
-import 'login_relay_diagram.dart';
+import 'box_chrome.dart';
+import 'terminal_progress.dart';
-/// The quiet bridge between opening Harness and reaching the user's workspace.
+/// The bridge between opening Harness and reaching the workspace.
///
-/// Bootstrap does not expose truthful percentage progress, so this screen names
-/// the current operation without inventing steps or a completion estimate. It
-/// shares the sign-in and pre-flight visual language so startup feels like one
-/// product instead of a framework spinner between two designed screens.
-class BootstrappingScreen extends StatelessWidget {
+/// Printed as a session, not as a screen: a prompt line, then each thing the
+/// app does as its own line, the way `harness start` would say it in a shell.
+/// The lines behind the current one stay on screen and dim, because that is
+/// what a terminal does with what it has already said — and it is the whole
+/// difference between "something is happening" and a spinner (owner,
+/// 2026-09-23). Everything is the terminal's face at the terminal's size.
+///
+/// Bootstrap cannot count what it is doing, so the bar carries a travelling
+/// block and prints no figure rather than inventing one.
+class BootstrappingScreen extends StatefulWidget {
const BootstrappingScreen({super.key, this.statusMessage});
final String? statusMessage;
- static const double _cardWidth = 420;
+ static const double _boxWidth = 470;
static const String _fallbackStatus = 'Opening Harness…';
+ @override
+ State<BootstrappingScreen> createState() => _BootstrappingScreenState();
+}
+
+class _BootstrappingScreenState extends State<BootstrappingScreen> {
+ /// Every status this screen has shown, oldest first. Bounded because a
+ /// bootstrap that keeps talking must not grow the box past the window.
+ final List<String> _printed = [];
+ static const _keep = 4;
+
+ @override
+ void initState() {
+ super.initState();
+ _print(widget.statusMessage ?? BootstrappingScreen._fallbackStatus);
+ }
+
+ @override
+ void didUpdateWidget(BootstrappingScreen old) {
+ super.didUpdateWidget(old);
+ _print(widget.statusMessage ?? BootstrappingScreen._fallbackStatus);
+ }
+
+ void _print(String line) {
+ if (_printed.isNotEmpty && _printed.last == line) return;
+ _printed.add(line);
+ if (_printed.length > _keep) _printed.removeAt(0);
+ }
+
@override
Widget build(BuildContext context) {
grid.AppTheme.watch(context);
- final reduceMotion = MediaQuery.disableAnimationsOf(context);
- final status = statusMessage ?? _fallbackStatus;
+ final status = widget.statusMessage ?? BootstrappingScreen._fallbackStatus;
+ final earlier = _printed.length > 1
+ ? _printed.sublist(0, _printed.length - 1)
+ : const <String>[];
return Scaffold(
- backgroundColor: grid.AppPalette.panelBg,
- body: Stack(
- children: [
- const Positioned.fill(child: LoginAurora()),
- Center(
- child: SingleChildScrollView(
- padding: const EdgeInsets.symmetric(vertical: 32, horizontal: 24),
- child: ConstrainedBox(
- constraints: const BoxConstraints(maxWidth: _cardWidth),
- child: Container(
- width: double.infinity,
- padding: const EdgeInsets.all(32),
- decoration: BoxDecoration(
- color: grid.AppGlass.surfaceFill,
- borderRadius: BorderRadius.circular(grid.AppCard.radius),
- boxShadow: grid.AppCard.shadow,
- ),
- child: Column(
- mainAxisSize: MainAxisSize.min,
- children: [
- const _BootAppMark(),
- const SizedBox(height: 20),
- Text(
- 'Getting Harness ready',
- textAlign: TextAlign.center,
- style: grid.AppType.display(),
- ),
- const SizedBox(height: 8),
- Text(
- 'Connecting this window to the local Harness service.',
- textAlign: TextAlign.center,
- style: Theme.of(context).textTheme.bodySmall,
- ),
- const SizedBox(height: 24),
- Semantics(
- key: const Key('boot-status'),
- container: true,
- liveRegion: true,
- label: 'Harness startup status',
- value: status,
- child: ExcludeSemantics(
- child: Container(
- width: double.infinity,
- padding: const EdgeInsets.symmetric(
- horizontal: 16,
- vertical: 14,
- ),
- decoration: BoxDecoration(
- color: grid.AppCard.inset,
- borderRadius: BorderRadius.circular(
- grid.AppCard.insetRadius,
+ backgroundColor: grid.AppPalette.swarmField,
+ body: Center(
+ child: SingleChildScrollView(
+ padding: const EdgeInsets.all(24),
+ child: ConstrainedBox(
+ constraints: const BoxConstraints(
+ maxWidth: BootstrappingScreen._boxWidth,
+ ),
+ child: TerminalBox(
+ child: Padding(
+ padding: const EdgeInsets.fromLTRB(16, 14, 16, 14),
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ Text(
+ '$kBootPrompt harness start',
+ style: boxMonoStyle(weight: FontWeight.w600),
+ ),
+ const SizedBox(height: 8),
+ for (final line in earlier) ...[
+ Text(line, style: boxMonoStyle(color: kBoxFaint)),
+ const SizedBox(height: 1),
+ ],
+ const SizedBox(height: 1),
+ const TerminalProgressLine(),
+ const SizedBox(height: 8),
+ Semantics(
+ key: const Key('boot-status'),
+ container: true,
+ liveRegion: true,
+ label: 'Harness startup status',
+ value: status,
+ child: ExcludeSemantics(
+ child: Row(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Flexible(
+ child: Text(
+ status,
+ key: ValueKey(status),
+ maxLines: 2,
+ overflow: TextOverflow.ellipsis,
+ style: boxMonoStyle(),
),
- border: Border.all(color: grid.AppCard.insetHair),
),
- child: Row(
- mainAxisAlignment: MainAxisAlignment.center,
- mainAxisSize: MainAxisSize.min,
- children: [
- TickerMode(
- key: const Key('boot-status-ticker'),
- enabled: !reduceMotion,
- child: const SizedBox(
- width: 18,
- height: 18,
- child: CircularProgressIndicator(
- strokeWidth: 2,
- ),
- ),
- ),
- const SizedBox(width: 12),
- Flexible(
- child: AnimatedSwitcher(
- duration: Duration.zero,
- child: Text(
- status,
- key: ValueKey(status),
- textAlign: TextAlign.center,
- style: Theme.of(context)
- .textTheme
- .labelLarge,
- ),
- ),
- ),
- ],
- ),
- ),
+ const SizedBox(width: 6),
+ const TerminalCursor(),
+ ],
),
),
- const SizedBox(height: 16),
- Text(
- 'This usually takes a few seconds.',
- textAlign: TextAlign.center,
- style: Theme.of(context).textTheme.labelSmall
- ?.copyWith(color: grid.AppPalette.textSecondary),
- ),
- ],
- ),
+ ),
+ ],
),
),
),
),
- ],
- ),
- );
- }
-}
-
-class _BootAppMark extends StatelessWidget {
- const _BootAppMark();
-
- @override
- Widget build(BuildContext context) {
- grid.AppTheme.watch(context);
- return Container(
- width: 56,
- height: 56,
- decoration: BoxDecoration(
- color: grid.AppCard.inset,
- borderRadius: BorderRadius.circular(12),
- ),
- alignment: Alignment.center,
- child: Image.asset(
- 'assets/app_icon.png',
- width: 36,
- height: 36,
- filterQuality: FilterQuality.medium,
+ ),
),
);
}
diff --git a/desktop/lib/widgets/environment_preflight_screen.dart b/desktop/lib/widgets/environment_preflight_screen.dart
index c9c790278..fe64a808b 100644
--- a/desktop/lib/widgets/environment_preflight_screen.dart
+++ b/desktop/lib/widgets/environment_preflight_screen.dart
@@ -2,135 +2,140 @@ import 'package:flutter/material.dart';
import '../bootstrap/environment_provisioner.dart';
import '../shared/theme/app_theme.dart' as grid;
-import 'login_relay_diagram.dart';
+import 'box_chrome.dart';
+import 'terminal_progress.dart';
-/// The quiet read-only gate shown before either sign-in or environment setup.
+/// The read-only gate shown before either sign-in or environment setup.
///
-/// This is deliberately not part of the environment setup wizard: a computer that
-/// is already ready should never look as though it has entered an installer.
-/// The ready state has no artificial dwell or action; it stays visible only
-/// while the app asks the local Harness CLI whether this user is signed in.
+/// Printed as a session, not as a screen: a prompt line, one line per thing
+/// checked with its answer in the same column, a bar counting what is done, and
+/// a cursor waiting at the end. Everything is the terminal's face at the
+/// terminal's size — one cell size, the way a terminal has one (owner,
+/// 2026-09-23). A person who has lived in a terminal has read this exact shape
+/// ten thousand times, which is the welcome.
+///
+/// The figure is honest because it is counted: each dependency the provisioner
+/// probed is a line, and the bar is how many of them have answered.
+///
+/// This is deliberately not part of the environment setup wizard: a computer
+/// that is already ready should never look as though it has entered an
+/// installer. The ready state has no artificial dwell or action; it stays
+/// visible only while the app asks the local Harness CLI whether this user is
+/// signed in.
class EnvironmentPreflightScreen extends StatelessWidget {
const EnvironmentPreflightScreen({super.key, required this.readiness});
final EnvironmentReadiness readiness;
+ /// What each dependency is called in the print-out. The enum names the thing
+ /// the app runs; these name it the way the person would say it.
+ static const _labels = {
+ EnvironmentStep.tmux: 'tmux',
+ EnvironmentStep.harness: 'harness cli',
+ EnvironmentStep.clipboard: 'clipboard helper',
+ };
+
@override
Widget build(BuildContext context) {
grid.AppTheme.watch(context);
final ready = readiness.isReady;
+ final steps = readiness.steps.entries
+ .where((entry) => _labels.containsKey(entry.key))
+ .toList();
+ final settled = steps.where((entry) => _settled(entry.value)).length;
+ final value = steps.isEmpty ? (ready ? 1.0 : null) : settled / steps.length;
return Scaffold(
- backgroundColor: grid.AppPalette.panelBg,
- body: Stack(
- children: [
- const Positioned.fill(child: LoginAurora()),
- Center(
- child: SingleChildScrollView(
- padding: const EdgeInsets.symmetric(vertical: 32, horizontal: 24),
- child: ConstrainedBox(
- constraints: const BoxConstraints(maxWidth: 420),
- child: Container(
- width: double.infinity,
- padding: const EdgeInsets.all(32),
- decoration: BoxDecoration(
- color: grid.AppGlass.surfaceFill,
- borderRadius: BorderRadius.circular(14),
- boxShadow: grid.AppCard.shadow,
- ),
- child: Semantics(
- key: const Key('environment-status'),
- container: true,
- liveRegion: true,
- label: 'Harness setup status',
- child: AnimatedSwitcher(
- duration: Duration.zero,
- child: ready
- ? const _ReadyContent(
- key: ValueKey('environment-ready'),
- )
- : const _CheckingContent(
- key: ValueKey('environment-checking'),
+ backgroundColor: grid.AppPalette.swarmField,
+ body: Center(
+ child: SingleChildScrollView(
+ padding: const EdgeInsets.all(24),
+ child: ConstrainedBox(
+ constraints: const BoxConstraints(maxWidth: 470),
+ child: TerminalBox(
+ child: Padding(
+ padding: const EdgeInsets.fromLTRB(16, 14, 16, 14),
+ child: Semantics(
+ key: const Key('environment-status'),
+ container: true,
+ liveRegion: true,
+ label: 'Harness setup status',
+ value: ready ? 'Environment ready' : 'Checking this computer',
+ child: ExcludeSemantics(
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ Text(
+ '$kBootPrompt harness doctor',
+ style: boxMonoStyle(weight: FontWeight.w600),
+ ),
+ const SizedBox(height: 8),
+ for (final entry in steps) ...[
+ TerminalCheckLine(
+ label: _labels[entry.key]!,
+ status: _status(entry.value),
+ ink: _ink(entry.value),
+ ),
+ const SizedBox(height: 1),
+ ],
+ const SizedBox(height: 9),
+ TerminalProgressLine(
+ value: ready ? 1 : value,
+ color: ready ? grid.AppPalette.online : null,
+ ),
+ const SizedBox(height: 8),
+ Row(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Flexible(
+ child: Text(
+ ready
+ ? 'all checks passed · opening your workspace'
+ : 'read-only: nothing is installed by this check',
+ style: boxMonoStyle(
+ color: ready ? null : kBoxFaint,
+ ),
+ ),
),
+ const SizedBox(width: 6),
+ const TerminalCursor(),
+ ],
+ ),
+ ],
),
),
),
),
),
),
- ],
+ ),
),
);
}
-}
-class _CheckingContent extends StatelessWidget {
- const _CheckingContent({super.key});
+ /// A step that has answered, whichever answer it gave.
+ static bool _settled(EnvironmentStepStatus status) => switch (status) {
+ EnvironmentStepStatus.pending || EnvironmentStepStatus.running => false,
+ _ => true,
+ };
- @override
- Widget build(BuildContext context) => Column(
- mainAxisSize: MainAxisSize.min,
- children: [
- SizedBox(
- width: 34,
- height: 34,
- child: MediaQuery.disableAnimationsOf(context)
- ? Icon(
- Icons.hourglass_empty_rounded,
- size: 34,
- color: Theme.of(context).colorScheme.primary,
- )
- : const CircularProgressIndicator(strokeWidth: 2.5),
- ),
- const SizedBox(height: 24),
- Text(
- 'Checking this computer',
- textAlign: TextAlign.center,
- style: grid.AppType.display(),
- ),
- const SizedBox(height: 8),
- Text(
- 'Verifying the tools Harness needs. This check is read-only and nothing is being installed.',
- textAlign: TextAlign.center,
- style: Theme.of(context).textTheme.bodySmall,
- ),
- ],
- );
-}
+ /// The word in the right-hand column, in a terminal's vocabulary.
+ static String _status(EnvironmentStepStatus status) => switch (status) {
+ EnvironmentStepStatus.ready => 'ok',
+ EnvironmentStepStatus.notApplicable => 'n/a',
+ EnvironmentStepStatus.failed => 'fail',
+ EnvironmentStepStatus.unavailable => 'missing',
+ EnvironmentStepStatus.needsTerminal => 'needs a terminal',
+ EnvironmentStepStatus.running => '..',
+ EnvironmentStepStatus.pending => '--',
+ };
-class _ReadyContent extends StatelessWidget {
- const _ReadyContent({super.key});
-
- @override
- Widget build(BuildContext context) {
- grid.AppTheme.watch(context);
- final success = grid.AppPalette.online;
- return Column(
- mainAxisSize: MainAxisSize.min,
- children: [
- Container(
- width: 48,
- height: 48,
- decoration: BoxDecoration(
- color: success.withValues(alpha: 0.12),
- shape: BoxShape.circle,
- ),
- alignment: Alignment.center,
- child: Icon(Icons.check_rounded, size: 28, color: success),
- ),
- const SizedBox(height: 20),
- Text(
- 'Environment ready',
- textAlign: TextAlign.center,
- style: grid.AppType.display(),
- ),
- const SizedBox(height: 8),
- Text(
- 'All required tools passed verification.',
- textAlign: TextAlign.center,
- style: Theme.of(context).textTheme.bodySmall,
- ),
- ],
- );
- }
+ static Color? _ink(EnvironmentStepStatus status) => switch (status) {
+ EnvironmentStepStatus.ready => grid.AppPalette.online,
+ EnvironmentStepStatus.failed ||
+ EnvironmentStepStatus.unavailable => grid.AppPalette.dangerFill,
+ EnvironmentStepStatus.needsTerminal => grid.AppPalette.warn,
+ _ => null,
+ };
}
diff --git a/desktop/lib/widgets/environment_setup_screen.dart b/desktop/lib/widgets/environment_setup_screen.dart
index a83d528a6..9fb8bf3ae 100644
--- a/desktop/lib/widgets/environment_setup_screen.dart
+++ b/desktop/lib/widgets/environment_setup_screen.dart
@@ -167,11 +167,20 @@ class _EnvironmentSetupScreenState extends State<EnvironmentSetupScreen> {
),
),
const SizedBox(height: 6),
- Text(title, style: grid.AppType.display()),
- const SizedBox(height: 8),
+ // Terminal type here too: setup is the first thing a new install shows,
+ // and it should read like the app it is about to open (owner,
+ // 2026-09-23). Weight and colour carry the hierarchy instead of size.
+ Text(
+ title,
+ style: terminalTextStyle(
+ fontWeight: FontWeight.w600,
+ color: AppColors.text,
+ ),
+ ),
+ const SizedBox(height: 6),
Text(
lead,
- style: grid.AppType.body(color: AppColors.textSoft, height: 1.55),
+ style: terminalTextStyle(color: AppColors.textSoft, height: 1.55),
),
const SizedBox(height: 16),
],
@@ -431,7 +440,10 @@ class _EnvironmentSetupScreenState extends State<EnvironmentSetupScreen> {
children: [
Text(
'${index + 1} · ${items[index].title}',
- style: grid.AppType.heading(),
+ style: terminalTextStyle(
+ fontWeight: FontWeight.w600,
+ color: AppColors.text,
+ ),
),
const SizedBox(height: 9),
CommandRow(
@@ -466,7 +478,13 @@ class _EnvironmentSetupScreenState extends State<EnvironmentSetupScreen> {
title: Row(
children: [
Expanded(
- child: Text('Setup details', style: grid.AppType.heading()),
+ child: Text(
+ 'Setup details',
+ style: terminalTextStyle(
+ fontWeight: FontWeight.w600,
+ color: AppColors.text,
+ ),
+ ),
),
TextButton.icon(
onPressed: () => _copy(diagnostics),
diff --git a/desktop/lib/widgets/terminal_progress.dart b/desktop/lib/widgets/terminal_progress.dart
new file mode 100644
index 000000000..8517be910
--- /dev/null
+++ b/desktop/lib/widgets/terminal_progress.dart
@@ -0,0 +1,233 @@
+import 'package:flutter/material.dart';
+
+import '../shared/theme/app_theme.dart' as grid;
+import 'box_chrome.dart';
+
+/// The prompt these boxes hang off.
+///
+/// `$`, not the app's own `❯`: SF Mono has no glyph for U+276F, so the prompt
+/// came out as a blank the width of a cell — a prompt nobody can see is worse
+/// than a plain one everybody has typed at.
+const String kBootPrompt = '\$';
+
+/// A progress line the way a terminal draws one: a spinner, a bracketed bar,
+/// and a figure — `- |████████ | 62%`.
+///
+/// The app opens on these before it can open a terminal, and they are the first
+/// thing anybody sees. A headline and a spinning ring announce an application
+/// launching; this announces something running in a terminal, which is what the
+/// person opened (owner, 2026-09-23).
+///
+/// `#` on blanks between square brackets, the bar every installer has drawn
+/// since the 1980s. Block glyphs (`█`, `░`) were the obvious try and are the
+/// wrong one: a proportional face's block does not tile, so the bar came out
+/// as a row of separate squares — the same reason the terminal renderer paints
+/// Block Elements itself rather than asking the font for them.
+///
+/// [value] null is the honest state while nothing can be counted: a block
+/// travels the bar instead of a fill growing, and no figure is printed. Under
+/// Reduce Motion nothing moves — the line stays legible, it just stops being a
+/// clock.
+class TerminalProgressLine extends StatefulWidget {
+ const TerminalProgressLine({
+ super.key,
+ this.value,
+ this.cells = 28,
+ this.color,
+ });
+
+ /// 0–1, or null while there is nothing to count.
+ final double? value;
+
+ /// How many glyphs the bar is wide. Fixed, so the line does not reflow as the
+ /// fill grows — the whole point of drawing it in a monospaced face.
+ final int cells;
+
+ final Color? color;
+
+ @override
+ State<TerminalProgressLine> createState() => _TerminalProgressLineState();
+}
+
+class _TerminalProgressLineState extends State<TerminalProgressLine>
+ with SingleTickerProviderStateMixin {
+ /// One turn of the spinner, and one sweep of the travelling block.
+ late final AnimationController _clock = AnimationController(
+ vsync: this,
+ duration: const Duration(milliseconds: 1400),
+ );
+
+ /// The four frames every terminal spinner has used since the 1980s.
+ static const _spinner = ['-', '\\', '|', '/'];
+ static const _fill = '#';
+
+ @override
+ void didChangeDependencies() {
+ super.didChangeDependencies();
+ // Started here rather than in initState, and only when motion is allowed: a
+ // controller left repeating under Reduce Motion keeps a frame scheduled
+ // forever, which a `pumpAndSettle` never settles and a test can see.
+ final still =
+ MediaQuery.disableAnimationsOf(context) || widget.value != null;
+ if (still && _clock.isAnimating) {
+ _clock.stop();
+ } else if (!still && !_clock.isAnimating) {
+ _clock.repeat();
+ }
+ }
+
+ @override
+ void dispose() {
+ _clock.dispose();
+ super.dispose();
+ }
+
+ @override
+ Widget build(BuildContext context) {
+ final still = !_clock.isAnimating;
+ final ink = widget.color ?? grid.AppPalette.textPrimary;
+ final track = ink.withValues(alpha: .22);
+ return AnimatedBuilder(
+ animation: _clock,
+ builder: (context, _) {
+ final t = still ? 0.0 : _clock.value;
+ final value = widget.value;
+ final filled = value == null
+ ? null
+ : (value.clamp(0.0, 1.0) * widget.cells).round();
+ // Where the travelling block sits while nothing can be counted.
+ final head = (t * widget.cells).floor();
+ final lit = <bool>[
+ for (var i = 0; i < widget.cells; i++)
+ filled != null ? i < filled : (i >= head - 3 && i <= head),
+ ];
+ // One span per run of like cells, so the bar is a handful of spans
+ // rather than one per glyph.
+ final spans = <TextSpan>[];
+ var start = 0;
+ for (var i = 1; i <= widget.cells; i++) {
+ if (i == widget.cells || lit[i] != lit[start]) {
+ spans.add(
+ TextSpan(
+ text: (lit[start] ? _fill : '·') * (i - start),
+ style: TextStyle(color: lit[start] ? ink : track),
+ ),
+ );
+ start = i;
+ }
+ }
+ final frame = _spinner[(t * _spinner.length).floor() % _spinner.length];
+ final figure = filled == null
+ ? ''
+ : ' ${(value!.clamp(0.0, 1.0) * 100).round()}%';
+ return Text.rich(
+ TextSpan(
+ children: [
+ TextSpan(text: '$frame ['),
+ ...spans,
+ TextSpan(text: ']$figure'),
+ ],
+ ),
+ maxLines: 1,
+ style: boxMonoStyle(color: ink),
+ );
+ },
+ );
+ }
+}
+
+/// The block that sits at the end of the last line, blinking the way a shell's
+/// does — the one thing that says a terminal is waiting rather than stuck.
+class TerminalCursor extends StatefulWidget {
+ const TerminalCursor({super.key, this.color});
+
+ final Color? color;
+
+ @override
+ State<TerminalCursor> createState() => _TerminalCursorState();
+}
+
+class _TerminalCursorState extends State<TerminalCursor>
+ with SingleTickerProviderStateMixin {
+ /// A shell's own rhythm: on for half of it, off for the other half.
+ late final AnimationController _blink = AnimationController(
+ vsync: this,
+ duration: const Duration(milliseconds: 1060),
+ );
+
+ @override
+ void didChangeDependencies() {
+ super.didChangeDependencies();
+ final still = MediaQuery.disableAnimationsOf(context);
+ if (still && _blink.isAnimating) {
+ _blink.stop();
+ } else if (!still && !_blink.isAnimating) {
+ _blink.repeat();
+ }
+ }
+
+ @override
+ void dispose() {
+ _blink.dispose();
+ super.dispose();
+ }
+
+ @override
+ Widget build(BuildContext context) => AnimatedBuilder(
+ animation: _blink,
+ builder: (context, _) => Opacity(
+ // Held on when nothing may move: a cursor is where you are, and it must
+ // not be the thing that disappeared.
+ opacity: !_blink.isAnimating || _blink.value < .5 ? 1 : 0,
+ child: Text(
+ '▌',
+ style: boxMonoStyle(color: widget.color ?? grid.AppPalette.textPrimary),
+ ),
+ ),
+ );
+}
+
+/// One printed check: `tmux ................... ok`.
+///
+/// The leader is dots to the same column on every row, which is how a terminal
+/// lines a list up without drawing a table.
+class TerminalCheckLine extends StatelessWidget {
+ const TerminalCheckLine({
+ super.key,
+ required this.label,
+ required this.status,
+ this.ink,
+ this.columns = 34,
+ });
+
+ final String label;
+ final String status;
+ final Color? ink;
+
+ /// The column the status starts in, counted in glyphs.
+ final int columns;
+
+ @override
+ Widget build(BuildContext context) {
+ final leader = '.' * (columns - label.length).clamp(1, columns);
+ return Text.rich(
+ TextSpan(
+ children: [
+ TextSpan(text: '$label '),
+ TextSpan(
+ text: leader,
+ style: TextStyle(
+ color: grid.AppPalette.textPrimary.withValues(alpha: .22),
+ ),
+ ),
+ TextSpan(
+ text: ' $status',
+ style: TextStyle(color: ink ?? grid.AppPalette.textPrimary),
+ ),
+ ],
+ ),
+ maxLines: 1,
+ style: boxMonoStyle(color: kBoxFaint),
+ );
+ }
+}
diff --git a/desktop/test/boot_flow_widget_test.dart b/desktop/test/boot_flow_widget_test.dart
index 8d4addad3..7ca8dbbd4 100644
--- a/desktop/test/boot_flow_widget_test.dart
+++ b/desktop/test/boot_flow_widget_test.dart
@@ -20,6 +20,7 @@ import 'package:harness/update/desktop_updater.dart';
import 'package:harness/update/manual_update_check.dart';
import 'package:harness/widgets/update_notice.dart';
import 'package:harness/widgets/bootstrapping_screen.dart';
+import 'package:harness/widgets/terminal_progress.dart';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
@@ -564,8 +565,8 @@ void main() {
// LoginScreen. Keep this on the real RootShell so notifier wiring remains
// covered as well as the standalone screen's presentation tests.
expect(find.byType(BootstrappingScreen), findsOneWidget);
- expect(find.byType(CircularProgressIndicator), findsOneWidget);
- expect(find.text('Getting Harness ready'), findsOneWidget);
+ expect(find.byType(TerminalProgressLine), findsOneWidget);
+ expect(find.text(r'$ harness start'), findsOneWidget);
expect(find.text('Opening Harness…'), findsOneWidget);
expect(find.text('Sign in'), findsNothing);
});
@@ -581,7 +582,7 @@ void main() {
);
await tester.pump();
- expect(find.text('Checking this computer'), findsOneWidget);
+ expect(find.text(r'$ harness doctor'), findsOneWidget);
expect(find.textContaining('read-only'), findsOneWidget);
expect(find.text('ENVIRONMENT SETUP'), findsNothing);
expect(find.text('Pre-flight check'), findsNothing);
@@ -610,7 +611,10 @@ void main() {
await tester.pump();
expect(app.status, AppStatus.checkingEnvironment);
- expect(find.text('Environment ready'), findsOneWidget);
+ expect(
+ find.text('all checks passed · opening your workspace'),
+ findsOneWidget,
+ );
expect(find.text('Continue to sign in'), findsNothing);
expect(find.text('ENVIRONMENT SETUP'), findsNothing);
@@ -865,14 +869,14 @@ void main() {
),
);
await tester.pump();
- expect(find.byType(CircularProgressIndicator), findsOneWidget);
+ expect(find.byType(TerminalProgressLine), findsOneWidget);
expect(find.text('Sign in'), findsNothing);
app.status = AppStatus.unauthenticated;
app.notifyListeners();
await tester.pump();
- expect(find.byType(CircularProgressIndicator), findsNothing);
+ expect(find.byType(TerminalProgressLine), findsNothing);
expect(find.text('Sign in'), findsOneWidget);
});
diff --git a/desktop/test/bootstrapping_screen_test.dart b/desktop/test/bootstrapping_screen_test.dart
index 0a9887c74..66d5e0bf1 100644
--- a/desktop/test/bootstrapping_screen_test.dart
+++ b/desktop/test/bootstrapping_screen_test.dart
@@ -2,7 +2,8 @@ import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:harness/shared/theme/app_theme.dart' as grid;
import 'package:harness/widgets/bootstrapping_screen.dart';
-import 'package:harness/widgets/login_relay_diagram.dart';
+import 'package:harness/widgets/box_chrome.dart';
+import 'package:harness/widgets/terminal_progress.dart';
Widget _host({
String? message,
@@ -26,19 +27,21 @@ Widget _host({
}
void main() {
- testWidgets('uses the app visual language and a truthful fallback status', (
+ testWidgets('is the terminal box, with a truthful fallback status', (
tester,
) async {
await tester.pumpWidget(_host());
await tester.pump(const Duration(milliseconds: 100));
- expect(find.byType(LoginAurora), findsOneWidget);
- expect(find.text('Getting Harness ready'), findsOneWidget);
+ // The first thing the app shows is the box the new tab uses, not a card
+ // with a headline: one terminal, from the first frame.
+ expect(find.byType(TerminalBox), findsOneWidget);
+ expect(find.text(r'$ harness start'), findsOneWidget);
expect(find.text('Opening Harness…'), findsOneWidget);
- expect(find.textContaining('few seconds'), findsOneWidget);
-
- final logo = tester.widget<Image>(find.byType(Image));
- expect((logo.image as AssetImage).assetName, 'assets/app_icon.png');
+ expect(find.byType(TerminalProgressLine), findsOneWidget);
+ // Nothing on the line is bigger than the terminal's own text.
+ final title = tester.widget<Text>(find.text(r'$ harness start'));
+ expect(title.style?.fontSize, boxMonoStyle().fontSize);
});
testWidgets('shows the daemon status as an accessible live update', (
@@ -56,16 +59,16 @@ void main() {
semantics.dispose();
});
- testWidgets('Reduce Motion freezes the indeterminate indicator', (
- tester,
- ) async {
+ testWidgets('Reduce Motion leaves the bar still', (tester) async {
await tester.pumpWidget(_host(reduceMotion: true));
await tester.pump(const Duration(milliseconds: 300));
- final ticker = tester.widget<TickerMode>(
- find.byKey(const Key('boot-status-ticker')),
+ expect(find.byType(TerminalProgressLine), findsOneWidget);
+ expect(
+ tester.binding.hasScheduledFrame,
+ isFalse,
+ reason: 'a bar that kept travelling would never settle',
);
- expect(ticker.enabled, isFalse);
});
testWidgets('fits the minimum window at the largest supported UI scale', (
@@ -80,7 +83,7 @@ void main() {
await tester.pump(const Duration(milliseconds: 100));
expect(tester.takeException(), isNull);
- expect(find.text('Getting Harness ready'), findsOneWidget);
+ expect(find.text(r'$ harness start'), findsOneWidget);
expect(find.text('Opening Harness…'), findsOneWidget);
});
}
diff --git a/desktop/test/environment_preflight_screen_test.dart b/desktop/test/environment_preflight_screen_test.dart
index a18da7a63..40ca647b3 100644
--- a/desktop/test/environment_preflight_screen_test.dart
+++ b/desktop/test/environment_preflight_screen_test.dart
@@ -3,6 +3,7 @@ import 'package:flutter_test/flutter_test.dart';
import 'package:harness/bootstrap/environment_provisioner.dart';
import 'package:harness/shared/theme/app_theme.dart' as grid;
import 'package:harness/widgets/environment_preflight_screen.dart';
+import 'package:harness/widgets/terminal_progress.dart';
Widget host(EnvironmentReadiness readiness, {bool reduceMotion = false}) =>
MaterialApp(
@@ -23,7 +24,7 @@ void main() {
);
await tester.pump(const Duration(milliseconds: 300));
expect(find.byType(CircularProgressIndicator), findsNothing);
- expect(find.byIcon(Icons.hourglass_empty_rounded), findsOneWidget);
+ expect(find.byType(TerminalProgressLine), findsOneWidget);
expect(tester.binding.hasScheduledFrame, isFalse);
});
@@ -45,7 +46,7 @@ void main() {
.isLiveRegion,
isTrue,
);
- expect(find.text('Checking this computer'), findsOneWidget);
+ expect(find.text(r'$ harness doctor'), findsOneWidget);
await tester.pumpWidget(
host(
EnvironmentReadiness(
@@ -59,8 +60,16 @@ void main() {
),
);
await tester.pump();
- expect(find.text('Environment ready'), findsOneWidget);
- expect(find.text('Checking this computer'), findsNothing);
+ expect(
+ find.text('all checks passed · opening your workspace'),
+ findsOneWidget,
+ );
+ // The prompt line is the same in both states; what changes is the line
+ // under the bar.
+ expect(
+ find.text('read-only: nothing is installed by this check'),
+ findsNothing,
+ );
expect(
tester
.getSemantics(status)
diff --git a/desktop/test/setup_review_render_test.dart b/desktop/test/setup_review_render_test.dart
index 27fc5a911..364d01e61 100644
--- a/desktop/test/setup_review_render_test.dart
+++ b/desktop/test/setup_review_render_test.dart
@@ -132,10 +132,7 @@ void main() {
),
);
await tester.pump();
- expect(
- find.text('Checking this computer').hitTestable(),
- findsOneWidget,
- );
+ expect(find.text(r'$ harness doctor').hitTestable(), findsOneWidget);
await capture('checking');
app.environmentReadiness = EnvironmentReadiness(
steps: {
@@ -147,7 +144,10 @@ void main() {
app.notifyListeners();
await tester.pump();
await tester.pump();
- expect(find.text('Environment ready').hitTestable(), findsOneWidget);
+ expect(
+ find.text('all checks passed · opening your workspace').hitTestable(),
+ findsOneWidget,
+ );
await capture('ready');
app.environmentReadiness = review;
app.notifyListeners();