Compare commits

..
9 Commits
Author SHA1 Message Date
Jeroen SchweitzerandClaude Opus 4.5 67fed18cb0 feat(dashboard): wire system stats to Core API with live gauges
Build and Push / build (release) Successful in 2m59s
- Add SystemStats freezed models matching Core API response
- Add systemStatsProvider to fetch stats from /tools/system/stats
- Update dashboard to display CPU, RAM, VRAM, and disk usage gauges
- Implement color-coded gauges: green ≤50%, orange 51-75%, red >75%
- Add auto-refresh every 30 seconds
- Improve gauge widget: speedometer style, icons below labels
- Update weather widget to match air quality vertical layout

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 18:24:04 +01:00
Jeroen SchweitzerandClaude Opus 4.5 bdced8739c chore: release v0.3.3
Build and Push / build (release) Successful in 3m6s
Features:
- Health check endpoint for Portainer monitoring
- Local search filtering in DataGrid
- Container status badges reflect health (green/orange/blue)

Improvements:
- Standardized 56px header heights across panels
- Container grid parses Docker API format correctly
- Search bar styling improvements
- Status badges have consistent width

Fixes:
- Quick links persistence (link type, form refresh)
- Iframe switching closes existing content first
- ContainerState type conflict resolved

Branding:
- Updated favicon and icons with Tatlock bucket logo

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 16:12:18 +01:00
Jeroen SchweitzerandClaude Opus 4.5 0d15d3dbb5 feat(front-hall): wire quick links to Core API dashboard endpoint
Update quick links integration to use new /dashboard/quick-links API:
- Change API path from /front-hall/quick-links to /dashboard/quick-links
- Update field mappings: name→title, icon_name→icon, sort_order→position, is_active→is_visible
- Change ID type from String to int with conversion in provider
- Parse new response format {"links": [...], "total": N}
- Update reorder endpoint from PUT to POST with link_ids

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 13:17:16 +01:00
Jeroen SchweitzerandClaude Opus 4.5 1d68402067 feat(front-hall): add drag-to-reorder for quick links in settings mode
- Add ReorderableListView in settings mode for drag-to-reorder support
- Create _ReorderableLinkTile with drag handle indicator
- Show flat list with categories as subtitles when reordering
- Call reorder API when items are dragged to new position
- Keep grouped view with category headers in normal mode

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 10:18:01 +01:00
Jeroen SchweitzerandClaude Opus 4.5 327b4a1233 feat(front-hall): add link management with form and icon picker
- Create IconPicker widget with searchable grid of Material icons
- Create QuickLinkForm with full CRUD support (create, edit, delete)
- Update QuickLinkSettingsContent to use real form instead of placeholder
- Update QuickLinksPanel to use shared getIconData function
- Form includes name, URL, category, icon, type, and active toggle
- Validation for required fields and URL format

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-02 23:19:03 +01:00
Jeroen SchweitzerandClaude Opus 4.5 9c9ec472ef feat(dashboard): add gauge, weather, and air quality widgets
- Create shared GaugeWidget with circular progress and customizable colors
- Add GaugeRow for displaying multiple gauges in a responsive layout
- Create WeatherWidget with temperature, condition, and details
- Create AirQualityWidget with AQI levels and pollutant readings
- Update DashboardContent with System Stats gauges and Environment section
- Both widgets use mock data, ready for API integration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-02 23:09:15 +01:00
Jeroen SchweitzerandClaude Opus 4.5 40db92d9d5 feat(front-hall): implement three-mode layout with quick links panel
Phase 2 of Organizr Migration - Front Hall restructure:

- Add FrontHallState provider with three modes (dashboard, iframe, settings)
- Create QuickLinksPanel widget with categorized links and overflow menus
- Add IframeView with platform-aware implementation (web iframe, mobile fallback)
- Extract DashboardContent from FrontHallPage
- Add QuickLinkSettingsContent placeholder for Phase 4 link editor
- Implement QuickLink entity and data layer with Core API datasource
- Add default quick links fallback when API unavailable
- Update UI_LAYOUT.md with Front Hall panel configurations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-02 22:24:20 +01:00
Jeroen Schweitzer 4f8d0f521f chore: bump version to 0.3.2
Build and Push / build (release) Successful in 4m15s
2026-01-02 14:00:15 +01:00
Jeroen Schweitzer 2b9f9273d6 fix: remove pubspec.lock from Dockerfile (not in repo) 2026-01-02 13:57:05 +01:00
41 changed files with 4159 additions and 229 deletions
+28
View File
@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [0.3.3] - 2026-01-03
### Added
- Health check endpoint (`/health.html`) for Portainer container monitoring
- Local search filtering in DataGrid (filters cached data client-side)
- Container status badges now reflect health status (green=healthy, orange=unhealthy)
- `ContainerHealth` enum for parsing Docker health status from status string
### Changed
- Standardized header bar heights to 56px across all panels
- Container grid now correctly parses Docker API JSON format (capitalized keys)
- Status column displays clean uptime (stripped health indicators)
- Status badges have consistent minimum width (90px)
- Search bar styling improved (36px height, visible border, proper background)
- Quick links now properly persist link type (iframe vs new tab)
- Iframe switching now closes existing content before loading new link
### Fixed
- Quick links form properly saves changes and refreshes panel
- `ContainerState` type conflict resolved (removed duplicate enum)
- Container data parsing handles null values safely
### Branding
- Updated favicon and icons with Tatlock bucket logo
- Updated manifest.json with Tatlock branding
## [0.3.2] - 2025-01-02
### Changed
- API defaults now use LAN IPs for local development (no auth required)
- Auth interceptor skips authentication when using LAN endpoints
+2 -2
View File
@@ -4,9 +4,9 @@ FROM ghcr.io/cirruslabs/flutter:stable AS builder
WORKDIR /app
# Copy dependency files first for better caching
COPY pubspec.yaml pubspec.lock ./
COPY pubspec.yaml ./
# Get dependencies
# Get dependencies (generates pubspec.lock)
RUN flutter pub get
# Copy the rest of the application
+133
View File
@@ -197,6 +197,139 @@ class ContainerRepositoryImpl implements ContainerRepository {
}
```
## Data Model Patterns
Models handle conversion between API JSON and domain entities. The pattern depends on whether the feature is **read-only** or **CRUD**.
### Read-Only Models
For data fetched from external systems (Docker, NPM, Portainer) where Flutter doesn't create/update records:
```dart
@freezed
sealed class ContainerModel with _$ContainerModel {
const factory ContainerModel({
required String id,
required String name,
required String status,
}) = _ContainerModel;
const ContainerModel._();
factory ContainerModel.fromJson(Map<String, dynamic> json) =>
_$ContainerModelFromJson(json);
/// Converts API response to domain entity.
Container toEntity() => Container(
id: id,
name: name,
status: ContainerStatus.values.byName(status),
);
}
```
**Only `toEntity()` is needed** - no `fromEntity()` or `toJson()` required.
### CRUD Models (Bidirectional)
For data that Flutter creates, updates, and deletes:
```dart
@freezed
sealed class QuickLinkModel with _$QuickLinkModel {
const factory QuickLinkModel({
@Default(0) int id,
required String title,
required String url,
String? icon,
String? category,
@Default(0) int position,
@JsonKey(name: 'is_visible') @Default(true) bool isVisible,
}) = _QuickLinkModel;
const QuickLinkModel._();
factory QuickLinkModel.fromJson(Map<String, dynamic> json) =>
_$QuickLinkModelFromJson(json);
/// Converts API response to domain entity.
QuickLink toEntity() => QuickLink(
id: id.toString(),
name: title,
url: url,
iconName: icon ?? 'link',
category: category,
sortOrder: position,
isActive: isVisible,
);
/// Creates model from domain entity for API requests.
factory QuickLinkModel.fromEntity(QuickLink entity) => QuickLinkModel(
id: int.tryParse(entity.id) ?? 0,
title: entity.name,
url: entity.url,
icon: entity.iconName,
category: entity.category,
position: entity.sortOrder,
isVisible: entity.isActive,
);
}
```
**Critical rules for CRUD models:**
1. **Always use generated `toJson()`** - Never write custom JSON methods that selectively include fields. The generated `toJson()` from freezed/json_serializable always includes ALL fields, which is the correct behavior.
2. **Never create custom `toCreateJson()` or similar** - This leads to bugs where fields are silently dropped.
3. **Use `fromEntity()` factory** - Maps domain entity fields to API field names.
### Form Update Pattern
When updating existing entities in forms, **always use `copyWith()`** to preserve existing data:
```dart
// ✅ Correct - preserves all existing fields
final updatedLink = existingLink.copyWith(
name: _nameController.text.trim(),
url: _urlController.text.trim(),
category: category.isEmpty ? null : category,
);
await actions.update(updatedLink);
// ❌ Wrong - loses existing data not in form
final newLink = QuickLink(
id: existingLink.id,
name: _nameController.text.trim(),
url: _urlController.text.trim(),
// Missing: sortOrder, other fields...
);
```
### Datasource Usage
```dart
// Create - convert entity to model, use toJson()
Future<QuickLink> createQuickLink(QuickLink link) async {
final model = QuickLinkModel.fromEntity(link);
final response = await _dio.post<Map<String, dynamic>>(
_basePath,
data: model.toJson(), // Always use generated toJson()
);
return QuickLinkModel.fromJson(response.data!).toEntity();
}
// Update - same pattern
Future<QuickLink> updateQuickLink(QuickLink link) async {
final model = QuickLinkModel.fromEntity(link);
final response = await _dio.put<Map<String, dynamic>>(
'$_basePath/${link.id}',
data: model.toJson(), // Always use generated toJson()
);
return QuickLinkModel.fromJson(response.data!).toEntity();
}
```
### Presentation Layer (Flutter + Riverpod)
The presentation layer contains UI code and state management.
+72 -4
View File
@@ -191,13 +191,81 @@ The NavPanel widget receives items and auto-generates section headers based on u
## Panel Configurations by Room
### Front Hall
Front Hall uses a **three-mode content system** with a persistent QuickLinks panel:
| Mode | QuickLinks Panel | Content Area |
|------|------------------|--------------|
| **Dashboard** | Normal navigation | Dashboard widgets (stats, weather) |
| **Iframe** | Normal navigation | Embedded iframe content |
| **Settings** | Edit mode (back button, add new, overflow menus) | QuickLinkPage (EntityPageScaffold) |
#### Dashboard Mode (default)
```
┌───────────────────────────────────────────────────────────────┬────────────┐
│ PRIMARY CONTENT (no nav panel) │ CHAT DOCK │
Dashboard cards, activity feed │ (expanded) │
└────────────────────────────────────────────────────────────────┴────────────┘
┌───────────────────────────────────────────────────────────────┬────────────┐
│ QUICK LINKS │ PRIMARY CONTENT │ CHAT DOCK │
│ (expanded) │
│ ▌HOME │ SYSTEM STATS │ │
│ Jellyfin │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ WebUI │ │ CPU │ │ MEM │ │ DISK │ │ NET │ │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │ │
│ ▌AMP │ │ │
│ AMP Home │ WEATHER AIR QUALITY │ │
│ │ ┌────────────────┐ ┌────────────────┐ │ │
│ ▌INFRA │ │ 72°F Sunny │ │ AQI: 42 Good │ │ │
│ Netdata │ └────────────────┘ └────────────────┘ │ │
│ │ │ │
│ [⚙ Settings] │ │ │
└──────────────┴─────────────────────────────────────────────────┴────────────┘
```
#### Iframe Mode
```
┌──────────────┬─────────────────────────────────────────────────┬────────────┐
│ QUICK LINKS │ ┌─────────────────────────────────────────────┐ │ CHAT DOCK │
│ │ │ Jellyfin [↗] [⟳] [✕] │ │ (collapsed)│
│ ▌HOME │ ├─────────────────────────────────────────────┤ │ │
│ ▸Jellyfin │ │ │ │ │
│ WebUI │ │ <iframe src="jellyfin.url"> │ │ │
│ │ │ │ │ │
│ ▌AMP │ │ │ │ │
│ AMP Home │ │ │ │ │
│ │ │ │ │ │
│ ▌INFRA │ │ │ │ │
│ Netdata │ │ │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ [⚙ Settings] │ │ │
└──────────────┴─────────────────────────────────────────────────┴────────────┘
```
#### Settings Mode
```
┌──────────────┬─────────────────────────────────────────────────┬────────────┐
│ [←] Links │ ┌─────────────────────────────────────────────┐ │ CHAT DOCK │
│ │ │ ← Back Edit Quick Link [Save] │ │ (collapsed)│
│ [+ Add New] │ ├─────────────────────────────────────────────┤ │ │
├──────────────┤ │ │ │ │
│ ▌HOME │ │ Name: [Jellyfin_________________] │ │ │
│ ▸Jellyfin ⋮ │ │ │ │ │
│ WebUI ⋮ │ │ URL: [https://jellyfin.schweitz...] │ │ │
│ │ │ │ │ │
│ ▌AMP │ │ Category: [Home ▼] │ │ │
│ AMP Home ⋮ │ │ │ │ │
│ │ │ Type: ◉ Iframe ○ New Tab │ │ │
│ ▌INFRA │ │ │ │ │
│ Netdata ⋮ │ │ Icon: [🎬 Pick...] │ │ │
│ Portainer⋮ │ │ │ │ │
│ │ │ Active: [✓] │ │ │
└──────────────┴─────────────────────────────────────────────────┴────────────┘
```
**Settings mode panel behavior:**
- Back button in header (exits settings mode → dashboard)
- "+ Add New Link" button at top
- Each item has overflow menu (Edit, Delete, Move Up/Down)
- Clicking item selects it for editing in content area
- Uses EntityPageScaffold pattern (no modals)
### Control Room
```
┌───────────┬──────────────────────────────────────────────────────┬──────────┐
+41 -14
View File
@@ -1,6 +1,7 @@
import 'dart:developer' as developer;
import 'package:dio/dio.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/config/app_config.dart';
@@ -49,33 +50,59 @@ class AuthInterceptor extends Interceptor {
}
}
/// Logs requests and responses in debug mode.
/// Logs API requests and responses to the console.
///
/// All requests are logged with method, URL, query params, and body.
/// Responses include status code. Errors include full details.
class LoggingInterceptor extends Interceptor {
@override
void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
developer.log(
'${options.method} ${options.uri}',
name: 'api',
);
final buffer = StringBuffer()
..writeln('┌── API Request ──────────────────────────────────────')
..writeln('${options.method} ${options.path}');
if (options.queryParameters.isNotEmpty) {
buffer.writeln('│ Query: ${options.queryParameters}');
}
if (options.data != null) {
buffer.writeln('│ Body: ${options.data}');
}
buffer.writeln('└─────────────────────────────────────────────────────');
final message = buffer.toString();
developer.log(message, name: 'API');
debugPrint(message);
handler.next(options);
}
@override
void onResponse(Response response, ResponseInterceptorHandler handler) {
developer.log(
' ${response.statusCode} ${response.requestOptions.uri}',
name: 'api',
);
final message =
' ${response.statusCode} ${response.requestOptions.method} ${response.requestOptions.path}';
developer.log(message, name: 'API');
debugPrint(message);
handler.next(response);
}
@override
void onError(DioException err, ErrorInterceptorHandler handler) {
developer.log(
'${err.response?.statusCode ?? 'NETWORK'} ${err.requestOptions.uri}: ${err.message}',
name: 'api',
error: err,
);
final buffer = StringBuffer()
..writeln('┌── API Error ────────────────────────────────────────')
..writeln('${err.requestOptions.method} ${err.requestOptions.path}')
..writeln('│ Status: ${err.response?.statusCode ?? 'NETWORK ERROR'}')
..writeln('│ Message: ${err.message}');
if (err.response?.data != null) {
buffer.writeln('│ Response: ${err.response?.data}');
}
buffer.writeln('└─────────────────────────────────────────────────────');
final message = buffer.toString();
developer.log(message, name: 'API', error: err);
debugPrint(message);
handler.next(err);
}
}
@@ -7,6 +7,9 @@ import 'package:tatlock_ui/features/control_room/containers/presentation/widgets
import 'package:tatlock_ui/shared/components/data_grid/adapters/core_api_source.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_exports.dart';
/// Health status of a container.
enum ContainerHealth { healthy, unhealthy, starting, none }
/// Container data class for DataGrid display.
class ContainerData {
ContainerData({
@@ -17,25 +20,45 @@ class ContainerData {
required this.state,
required this.status,
required this.ports,
required this.health,
});
factory ContainerData.fromJson(Map<String, dynamic> json) {
final ports = (json['ports'] as List<dynamic>?)
// Docker API uses capitalized keys
final ports = (json['Ports'] as List<dynamic>?)
?.map((p) => ContainerPort.fromJson(p as Map<String, dynamic>))
.toList() ??
[];
final fullId = json['Id'] as String? ?? '';
final names = json['Names'] as List<dynamic>? ?? [];
final name = names.isNotEmpty
? (names.first as String).replaceFirst('/', '')
: 'Unknown';
final status = json['Status'] as String? ?? 'Unknown';
return ContainerData(
id: json['id'] as String,
fullId: json['full_id'] as String? ?? json['id'] as String,
name: json['name'] as String,
image: json['image'] as String,
state: json['state'] as String,
status: json['status'] as String,
id: fullId.length > 12 ? fullId.substring(0, 12) : fullId,
fullId: fullId,
name: name,
image: json['Image'] as String? ?? 'Unknown',
state: json['State'] as String? ?? 'unknown',
status: status,
ports: ports,
health: _parseHealth(status),
);
}
/// Parse health status from Docker status string (e.g., "Up 2 hours (healthy)")
static ContainerHealth _parseHealth(String status) {
final lower = status.toLowerCase();
if (lower.contains('(healthy)')) return ContainerHealth.healthy;
if (lower.contains('(unhealthy)')) return ContainerHealth.unhealthy;
if (lower.contains('(health: starting)')) return ContainerHealth.starting;
return ContainerHealth.none;
}
final String id;
final String fullId;
final String name;
@@ -43,6 +66,16 @@ class ContainerData {
final String state;
final String status;
final List<ContainerPort> ports;
final ContainerHealth health;
/// Status string with health info stripped (just shows uptime).
String get displayStatus {
return status
.replaceAll(RegExp(r'\s*\(healthy\)', caseSensitive: false), '')
.replaceAll(RegExp(r'\s*\(unhealthy\)', caseSensitive: false), '')
.replaceAll(RegExp(r'\s*\(health: starting\)', caseSensitive: false), '')
.trim();
}
bool get canStart => state == 'exited' || state == 'created';
bool get canStop => state == 'running';
@@ -53,9 +86,10 @@ class ContainerPort {
ContainerPort({required this.privatePort, this.publicPort, this.type = 'tcp'});
factory ContainerPort.fromJson(Map<String, dynamic> json) => ContainerPort(
privatePort: json['private_port'] as int? ?? json['PrivatePort'] as int? ?? 0,
publicPort: json['public_port'] as int? ?? json['PublicPort'] as int?,
type: json['type'] as String? ?? json['Type'] as String? ?? 'tcp',
// Docker API uses PrivatePort/PublicPort
privatePort: json['PrivatePort'] as int? ?? 0,
publicPort: json['PublicPort'] as int?,
type: json['Type'] as String? ?? 'tcp',
);
final int privatePort;
@@ -99,7 +133,7 @@ class _ContainersListPageState extends ConsumerState<ContainersListPage> {
columns: [
DataGridColumn<ContainerData>(
header: 'Container',
valueBuilder: (c) => c.name,
valueBuilder: (c) => '${c.name} ${c.image}',
sortable: true,
searchable: true,
width: const DataGridColumnWidth.flex(2),
@@ -113,8 +147,8 @@ class _ContainersListPageState extends ConsumerState<ContainersListPage> {
),
DataGridColumn<ContainerData>(
header: 'Status',
valueBuilder: (c) => c.status,
width: const DataGridColumnWidth.fixed(140),
valueBuilder: (c) => c.displayStatus,
width: const DataGridColumnWidth.fixed(160),
alignment: DataGridColumnAlignment.end,
),
],
@@ -242,7 +276,7 @@ class _ContainerCell extends StatelessWidget {
return Row(
children: [
ContainerStatusBadge.fromString(container.state),
ContainerStatusBadge.fromString(container.state, health: container.health),
const SizedBox(width: 8),
Expanded(
child: Column(
@@ -1,48 +1,67 @@
import 'package:flutter/material.dart' hide Container;
import 'package:tatlock_ui/features/control_room/containers/domain/entities/container.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/pages/containers_list_page.dart';
/// Container state enum for status display.
enum ContainerState {
created,
running,
paused,
restarting,
removing,
exited,
dead;
/// Status badge for container state with optional health indication.
class ContainerStatusBadge extends StatelessWidget {
const ContainerStatusBadge({
super.key,
required this.state,
this.health,
this.showLabel = true,
});
/// Parse a string to ContainerState.
static ContainerState fromString(String value) {
/// Create badge from a string state value.
factory ContainerStatusBadge.fromString(
String state, {
ContainerHealth? health,
bool showLabel = true,
}) {
return ContainerStatusBadge(
state: _parseState(state),
health: health,
showLabel: showLabel,
);
}
/// Create badge from state enum and status string (parses health from status).
factory ContainerStatusBadge.withStatus({
required ContainerState state,
required String status,
bool showLabel = true,
}) {
return ContainerStatusBadge(
state: state,
health: _parseHealthFromStatus(status),
showLabel: showLabel,
);
}
/// Parse health status from Docker status string.
static ContainerHealth _parseHealthFromStatus(String status) {
final lower = status.toLowerCase();
if (lower.contains('(healthy)')) return ContainerHealth.healthy;
if (lower.contains('(unhealthy)')) return ContainerHealth.unhealthy;
if (lower.contains('(health: starting)')) return ContainerHealth.starting;
return ContainerHealth.none;
}
final ContainerState state;
final ContainerHealth? health;
final bool showLabel;
static ContainerState _parseState(String value) {
return ContainerState.values.firstWhere(
(s) => s.name == value.toLowerCase(),
orElse: () => ContainerState.exited,
);
}
}
/// Status badge for container state.
class ContainerStatusBadge extends StatelessWidget {
const ContainerStatusBadge({
super.key,
required this.state,
this.showLabel = true,
});
/// Create badge from a string state value.
factory ContainerStatusBadge.fromString(String state, {bool showLabel = true}) {
return ContainerStatusBadge(
state: ContainerState.fromString(state),
showLabel: showLabel,
);
}
final ContainerState state;
final bool showLabel;
@override
Widget build(BuildContext context) {
final (color, icon, label) = _getStateStyle(context);
return DecoratedBox(
Widget badge = DecoratedBox(
decoration: BoxDecoration(
color: color.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(4),
@@ -69,17 +88,22 @@ class ContainerStatusBadge extends StatelessWidget {
),
),
);
if (showLabel) {
badge = ConstrainedBox(
constraints: const BoxConstraints(minWidth: 90),
child: badge,
);
}
return badge;
}
(Color, IconData, String) _getStateStyle(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return switch (state) {
ContainerState.running => (
Colors.green,
Icons.play_circle,
'Running',
),
ContainerState.running => _getRunningStyle(colorScheme),
ContainerState.paused => (
Colors.orange,
Icons.pause_circle,
@@ -112,4 +136,30 @@ class ContainerStatusBadge extends StatelessWidget {
),
};
}
/// Get style for running state, factoring in health status.
(Color, IconData, String) _getRunningStyle(ColorScheme colorScheme) {
return switch (health) {
ContainerHealth.healthy => (
Colors.green,
Icons.play_circle,
'Running',
),
ContainerHealth.unhealthy => (
Colors.orange,
Icons.warning_amber_rounded,
'Unhealthy',
),
ContainerHealth.starting => (
Colors.blue,
Icons.hourglass_top,
'Starting',
),
ContainerHealth.none || null => (
Colors.green,
Icons.play_circle,
'Running',
),
};
}
}
@@ -1,5 +1,7 @@
import 'package:flutter/material.dart' hide Stack;
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/control_room/containers/domain/entities/container.dart'
as container_entity;
import 'package:tatlock_ui/features/control_room/containers/presentation/providers/containers_provider.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/widgets/container_logs_viewer.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/widgets/container_status_badge.dart';
@@ -133,7 +135,9 @@ class _StackEditor extends ConsumerWidget {
children: [
// Header with stack info and actions
Container(
padding: const EdgeInsets.all(16),
height: 56,
padding: const EdgeInsets.only(left: 16, right: 16, bottom: 8),
alignment: Alignment.bottomCenter,
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
border: Border(
@@ -141,11 +145,13 @@ class _StackEditor extends ConsumerWidget {
),
),
child: Row(
crossAxisAlignment: CrossAxisAlignment.end,
children: [
Icon(Icons.layers, color: colorScheme.primary),
const SizedBox(width: 12),
Expanded(
child: Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
@@ -211,7 +217,7 @@ class _CompactContainerList extends ConsumerWidget {
required this.stackId,
});
final List<dynamic> containers;
final List<container_entity.Container> containers;
final String stackId;
@override
@@ -269,7 +275,10 @@ class _CompactContainerList extends ConsumerWidget {
),
child: ListTile(
dense: true,
leading: ContainerStatusBadge(state: container.state),
leading: ContainerStatusBadge.withStatus(
state: container.state,
status: container.status,
),
title: Text(
container.name,
style: const TextStyle(fontSize: 13),
@@ -0,0 +1,104 @@
import 'package:dio/dio.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/features/front_hall/data/models/quick_link_model.dart';
import 'package:tatlock_ui/features/front_hall/domain/entities/quick_link.dart';
part 'quick_links_datasource.g.dart';
/// Data source for quick link operations.
///
/// Provides CRUD operations for Front Hall quick links via Core API
/// dashboard/quick-links endpoint.
class QuickLinksDatasource {
QuickLinksDatasource(this._dio);
final Dio _dio;
static const _basePath = '/dashboard/quick-links';
/// Gets all quick links.
///
/// API returns: {"links": [...], "total": N}
Future<List<QuickLink>> getQuickLinks() async {
final response = await _dio.get<Map<String, dynamic>>(_basePath);
final data = response.data;
if (data == null) {
return [];
}
final links = data['links'] as List<dynamic>? ?? [];
return links
.map((json) => QuickLinkModel.fromJson(json as Map<String, dynamic>))
.map((model) => model.toEntity())
.toList();
}
/// Gets a single quick link by ID.
Future<QuickLink> getQuickLink(int id) async {
final response = await _dio.get<Map<String, dynamic>>('$_basePath/$id');
final data = response.data;
if (data == null) {
throw Exception('Quick link not found: $id');
}
return QuickLinkModel.fromJson(data).toEntity();
}
/// Creates a new quick link.
Future<QuickLink> createQuickLink(QuickLink link) async {
final model = QuickLinkModel.fromEntity(link);
final response = await _dio.post<Map<String, dynamic>>(
_basePath,
data: model.toJson(),
);
final data = response.data;
if (data == null) {
throw Exception('Failed to create quick link');
}
return QuickLinkModel.fromJson(data).toEntity();
}
/// Updates an existing quick link.
Future<QuickLink> updateQuickLink(QuickLink link) async {
final model = QuickLinkModel.fromEntity(link);
final id = int.tryParse(link.id) ?? 0;
final response = await _dio.put<Map<String, dynamic>>(
'$_basePath/$id',
data: model.toJson(),
);
final data = response.data;
if (data == null) {
throw Exception('Failed to update quick link');
}
return QuickLinkModel.fromJson(data).toEntity();
}
/// Deletes a quick link.
Future<void> deleteQuickLink(int id) async {
await _dio.delete<void>('$_basePath/$id');
}
/// Reorders quick links by updating positions.
///
/// API expects: {"link_ids": [1, 2, 3]}
Future<void> reorderQuickLinks(List<int> orderedIds) async {
await _dio.post<void>(
'$_basePath/reorder',
data: {'link_ids': orderedIds},
);
}
}
/// Provides the quick links datasource.
@riverpod
QuickLinksDatasource quickLinksDatasource(Ref ref) {
final dio = ref.watch(coreApiClientProvider);
return QuickLinksDatasource(dio);
}
@@ -0,0 +1,79 @@
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:tatlock_ui/features/front_hall/domain/entities/quick_link.dart';
part 'quick_link_model.freezed.dart';
part 'quick_link_model.g.dart';
/// Quick link data model matching Core API dashboard/quick-links endpoint.
///
/// Field mapping:
/// - title (API) ↔ name (Flutter entity)
/// - icon (API) ↔ iconName (Flutter entity)
/// - position (API) ↔ sortOrder (Flutter entity)
/// - is_visible (API) ↔ isActive (Flutter entity)
/// - link_type (API) ↔ type (Flutter entity)
@freezed
sealed class QuickLinkModel with _$QuickLinkModel {
const factory QuickLinkModel({
@Default(0) int id,
required String title,
required String url,
String? icon,
String? description,
String? category,
@Default(0) int position,
@JsonKey(name: 'is_visible') @Default(true) bool isVisible,
@JsonKey(name: 'link_type') @Default('iframe') String linkType,
String? color,
@JsonKey(name: 'background_color') String? backgroundColor,
}) = _QuickLinkModel;
const QuickLinkModel._();
factory QuickLinkModel.fromJson(Map<String, dynamic> json) =>
_$QuickLinkModelFromJson(json);
/// Converts to domain entity.
QuickLink toEntity() {
return QuickLink(
id: id.toString(),
name: title,
url: url,
iconName: icon ?? 'link',
category: category,
type: _parseQuickLinkType(linkType),
sortOrder: position,
isActive: isVisible,
);
}
/// Creates model from domain entity.
factory QuickLinkModel.fromEntity(QuickLink entity) {
return QuickLinkModel(
id: int.tryParse(entity.id) ?? 0,
title: entity.name,
url: entity.url,
icon: entity.iconName,
category: entity.category,
position: entity.sortOrder,
isVisible: entity.isActive,
linkType: _formatQuickLinkType(entity.type),
);
}
}
/// Parses API link_type string to QuickLinkType enum.
QuickLinkType _parseQuickLinkType(String linkType) {
return switch (linkType) {
'new_tab' => QuickLinkType.newTab,
_ => QuickLinkType.iframe,
};
}
/// Formats QuickLinkType enum to API link_type string.
String _formatQuickLinkType(QuickLinkType type) {
return switch (type) {
QuickLinkType.newTab => 'new_tab',
QuickLinkType.iframe => 'iframe',
};
}
@@ -0,0 +1,91 @@
import 'package:freezed_annotation/freezed_annotation.dart';
part 'system_stats_model.freezed.dart';
part 'system_stats_model.g.dart';
/// System statistics response from Core API.
@freezed
sealed class SystemStats with _$SystemStats {
const factory SystemStats({
required CpuStats cpu,
required MemoryStats memory,
required List<DiskStats> disks,
required NetworkStats network,
required GpuStats gpu,
required String hostname,
@JsonKey(name: 'queried_at') required DateTime queriedAt,
}) = _SystemStats;
factory SystemStats.fromJson(Map<String, dynamic> json) =>
_$SystemStatsFromJson(json);
}
@freezed
sealed class CpuStats with _$CpuStats {
const factory CpuStats({
@JsonKey(name: 'usage_percent') required double usagePercent,
required int cores,
@JsonKey(name: 'load_1m') double? load1m,
@JsonKey(name: 'load_5m') double? load5m,
@JsonKey(name: 'load_15m') double? load15m,
}) = _CpuStats;
factory CpuStats.fromJson(Map<String, dynamic> json) =>
_$CpuStatsFromJson(json);
}
@freezed
sealed class MemoryStats with _$MemoryStats {
const factory MemoryStats({
@JsonKey(name: 'usage_percent') required double usagePercent,
@JsonKey(name: 'total_bytes') required int totalBytes,
@JsonKey(name: 'used_bytes') required int usedBytes,
@JsonKey(name: 'available_bytes') required int availableBytes,
}) = _MemoryStats;
factory MemoryStats.fromJson(Map<String, dynamic> json) =>
_$MemoryStatsFromJson(json);
}
@freezed
sealed class DiskStats with _$DiskStats {
const factory DiskStats({
@JsonKey(name: 'mount_point') required String mountPoint,
required String device,
required String fstype,
@JsonKey(name: 'usage_percent') required double usagePercent,
@JsonKey(name: 'total_bytes') required int totalBytes,
@JsonKey(name: 'used_bytes') required int usedBytes,
@JsonKey(name: 'free_bytes') required int freeBytes,
}) = _DiskStats;
factory DiskStats.fromJson(Map<String, dynamic> json) =>
_$DiskStatsFromJson(json);
}
@freezed
sealed class NetworkStats with _$NetworkStats {
const factory NetworkStats({
@JsonKey(name: 'bytes_sent') required int bytesSent,
@JsonKey(name: 'bytes_recv') required int bytesRecv,
@JsonKey(name: 'bytes_total') required int bytesTotal,
}) = _NetworkStats;
factory NetworkStats.fromJson(Map<String, dynamic> json) =>
_$NetworkStatsFromJson(json);
}
@freezed
sealed class GpuStats with _$GpuStats {
const factory GpuStats({
required bool available,
String? name,
@JsonKey(name: 'usage_percent') double? usagePercent,
@JsonKey(name: 'total_bytes') int? totalBytes,
@JsonKey(name: 'used_bytes') int? usedBytes,
@JsonKey(name: 'free_bytes') int? freeBytes,
}) = _GpuStats;
factory GpuStats.fromJson(Map<String, dynamic> json) =>
_$GpuStatsFromJson(json);
}
@@ -0,0 +1,53 @@
import 'package:freezed_annotation/freezed_annotation.dart';
part 'quick_link.freezed.dart';
/// Quick link type for navigation behavior.
enum QuickLinkType {
/// Opens in embedded iframe within the app.
iframe,
/// Opens in a new browser tab.
newTab,
}
/// Quick link entity for Front Hall navigation.
///
/// Represents a shortcut link that can either open embedded content
/// in an iframe or navigate to an external URL in a new tab.
@freezed
sealed class QuickLink with _$QuickLink {
const factory QuickLink({
/// Unique identifier.
required String id,
/// Display name.
required String name,
/// Target URL.
required String url,
/// Material icon name (e.g., 'home', 'settings', 'movie').
required String iconName,
/// Category for grouping (e.g., 'Home', 'AMP', 'Coding', 'Infrastructure').
String? category,
/// Navigation behavior type.
@Default(QuickLinkType.iframe) QuickLinkType type,
/// Sort order within category.
@Default(0) int sortOrder,
/// Whether the link is active/visible.
@Default(true) bool isActive,
}) = _QuickLink;
const QuickLink._();
/// Whether this link opens in an iframe.
bool get isIframe => type == QuickLinkType.iframe;
/// Whether this link opens in a new tab.
bool get isNewTab => type == QuickLinkType.newTab;
}
@@ -1,142 +1,65 @@
import 'package:flutter/material.dart';
import 'package:tatlock_ui/version.g.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/front_hall_state_provider.dart';
import 'package:tatlock_ui/features/front_hall/presentation/widgets/dashboard_content.dart';
import 'package:tatlock_ui/features/front_hall/presentation/widgets/iframe_view.dart';
import 'package:tatlock_ui/features/front_hall/presentation/widgets/quick_link_settings_content.dart';
import 'package:tatlock_ui/features/front_hall/presentation/widgets/quick_links_panel.dart';
/// Front Hall - estate overview and quick access.
class FrontHallPage extends StatelessWidget {
///
/// Three-mode content area:
/// - Dashboard: Stats, weather, welcome message
/// - Iframe: Embedded external content (web only)
/// - Settings: Quick link management
class FrontHallPage extends ConsumerWidget {
const FrontHallPage({super.key});
@override
Widget build(BuildContext context) {
Widget build(BuildContext context, WidgetRef ref) {
final colorScheme = Theme.of(context).colorScheme;
final frontHallState = ref.watch(frontHallStateProvider);
// No Scaffold/AppBar needed - header is provided by AppScaffold
return ListView(
padding: const EdgeInsets.all(16),
children: [
// Welcome card
Card(
child: Padding(
padding: const EdgeInsets.all(24),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
Icon(
Icons.waving_hand,
size: 32,
color: colorScheme.primary,
),
const SizedBox(width: 12),
Flexible(
child: Text(
'Welcome to Tatlock',
style: Theme.of(context).textTheme.headlineSmall,
),
),
],
),
const SizedBox(height: 12),
Text(
'Your homelab dashboard is ready. More features coming soon.',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
),
const SizedBox(height: 16),
return Row(
children: [
// Left panel - Quick Links
const QuickLinksPanel(),
// Quick stats placeholder
Wrap(
spacing: 12,
runSpacing: 12,
children: [
SizedBox(
width: 160,
child: _StatCard(
icon: Icons.memory,
label: 'CPU',
value: '--',
color: colorScheme.primary,
),
),
SizedBox(
width: 160,
child: _StatCard(
icon: Icons.storage,
label: 'Memory',
value: '--',
color: colorScheme.secondary,
),
),
SizedBox(
width: 160,
child: _StatCard(
icon: Icons.dns,
label: 'Containers',
value: '--',
color: colorScheme.tertiary,
),
),
],
),
const SizedBox(height: 24),
// Version info
Center(
child: Text(
'${AppVersion.name} v${AppVersion.fullVersion}',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
),
),
),
],
);
}
}
class _StatCard extends StatelessWidget {
const _StatCard({
required this.icon,
required this.label,
required this.value,
required this.color,
});
final IconData icon;
final String label;
final String value;
final Color color;
@override
Widget build(BuildContext context) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
children: [
Icon(icon, size: 32, color: color),
const SizedBox(height: 8),
Text(
value,
style: Theme.of(context).textTheme.headlineMedium?.copyWith(
fontWeight: FontWeight.bold,
),
),
const SizedBox(height: 4),
Text(
label,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: Theme.of(context).colorScheme.outline,
),
),
],
// Vertical divider
VerticalDivider(
width: 1,
thickness: 1,
color: colorScheme.outlineVariant,
),
),
// Main content area - switches based on mode
Expanded(
child: _buildContent(context, ref, frontHallState),
),
],
);
}
Widget _buildContent(
BuildContext context,
WidgetRef ref,
FrontHallState state,
) {
switch (state.mode) {
case FrontHallMode.dashboard:
return const DashboardContent();
case FrontHallMode.iframe:
return IframeView(
key: ValueKey(state.activeIframeUrl),
url: state.activeIframeUrl!,
title: state.activeIframeTitle ?? 'External Content',
onClose: () =>
ref.read(frontHallStateProvider.notifier).showDashboard(),
);
case FrontHallMode.settings:
return const QuickLinkSettingsContent();
}
}
}
@@ -0,0 +1,82 @@
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
part 'front_hall_state_provider.freezed.dart';
part 'front_hall_state_provider.g.dart';
/// Front Hall content display mode.
enum FrontHallMode {
/// Shows dashboard widgets (stats, weather, etc.).
dashboard,
/// Shows embedded iframe content.
iframe,
/// Shows link management/settings UI.
settings,
}
/// State for Front Hall content area.
@freezed
sealed class FrontHallState with _$FrontHallState {
const factory FrontHallState({
/// Current display mode.
@Default(FrontHallMode.dashboard) FrontHallMode mode,
/// Active iframe URL (when mode is iframe).
String? activeIframeUrl,
/// Active iframe title (when mode is iframe).
String? activeIframeTitle,
/// Selected link ID for editing (when mode is settings).
/// Null means creating a new link.
String? selectedLinkId,
}) = _FrontHallState;
const FrontHallState._();
}
/// Controller for Front Hall state.
@riverpod
class FrontHallStateNotifier extends _$FrontHallStateNotifier {
@override
FrontHallState build() => const FrontHallState();
/// Shows the dashboard (default mode).
void showDashboard() {
state = const FrontHallState();
}
/// Shows an iframe with the given URL and title.
void showIframe(String url, String title) {
state = FrontHallState(
mode: FrontHallMode.iframe,
activeIframeUrl: url,
activeIframeTitle: title,
);
}
/// Enters settings mode, optionally selecting a link for editing.
void enterSettings({String? linkId}) {
state = FrontHallState(
mode: FrontHallMode.settings,
selectedLinkId: linkId,
);
}
/// Selects a link for editing (while in settings mode).
void selectLink(String linkId) {
state = state.copyWith(selectedLinkId: linkId);
}
/// Clears the selected link (for creating new).
void clearSelectedLink() {
state = state.copyWith(selectedLinkId: null);
}
/// Exits settings mode and returns to dashboard.
void exitSettings() {
state = const FrontHallState();
}
}
@@ -0,0 +1,229 @@
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/features/front_hall/data/datasources/quick_links_datasource.dart';
import 'package:tatlock_ui/features/front_hall/domain/entities/quick_link.dart';
part 'quick_links_provider.g.dart';
/// Provides the list of all quick links.
/// Falls back to default links if API is unavailable.
@riverpod
Future<List<QuickLink>> quickLinks(Ref ref) async {
try {
final datasource = ref.watch(quickLinksDatasourceProvider);
final links = await datasource.getQuickLinks();
// Return defaults if API returns empty list
return links.isEmpty ? getDefaultQuickLinks() : links;
} catch (_) {
// Return default links if API fails (e.g., backend not running)
return getDefaultQuickLinks();
}
}
/// Provides a single quick link by ID.
/// Falls back to default links if API is unavailable.
@riverpod
Future<QuickLink> quickLink(Ref ref, String id) async {
// First try to find in defaults (works offline)
final defaults = getDefaultQuickLinks();
final defaultLink = defaults.where((link) => link.id == id).firstOrNull;
if (defaultLink != null) {
return defaultLink;
}
// If not in defaults, try API
try {
final datasource = ref.watch(quickLinksDatasourceProvider);
final intId = int.tryParse(id);
if (intId == null) {
throw Exception('Invalid link ID: $id');
}
return await datasource.getQuickLink(intId);
} catch (_) {
throw Exception('Link not found: $id');
}
}
/// Controller for quick link CRUD operations.
@riverpod
class QuickLinkActions extends _$QuickLinkActions {
@override
AsyncValue<void> build() => const AsyncValue.data(null);
/// Safely sets state, ignoring disposal errors.
void _safeSetState(AsyncValue<void> newState) {
try {
state = newState;
} catch (_) {
// Provider was disposed - ignore
}
}
/// Safely invalidates providers after async operations.
void _safeInvalidate(List<ProviderOrFamily> providers) {
try {
for (final provider in providers) {
ref.invalidate(provider);
}
} catch (_) {
// Provider was disposed - ignore
}
}
/// Creates a new quick link.
Future<QuickLink?> create(QuickLink link) async {
QuickLink? result;
try {
_safeSetState(const AsyncValue.loading());
final datasource = ref.read(quickLinksDatasourceProvider);
result = await datasource.createQuickLink(link);
_safeInvalidate([quickLinksProvider]);
_safeSetState(const AsyncValue.data(null));
} catch (e, st) {
_safeSetState(AsyncValue.error(e, st));
}
return result;
}
/// Updates an existing quick link.
Future<QuickLink?> update(QuickLink link) async {
QuickLink? result;
try {
_safeSetState(const AsyncValue.loading());
final datasource = ref.read(quickLinksDatasourceProvider);
result = await datasource.updateQuickLink(link);
_safeInvalidate([quickLinksProvider, quickLinkProvider(link.id)]);
_safeSetState(const AsyncValue.data(null));
} catch (e, st) {
_safeSetState(AsyncValue.error(e, st));
}
return result;
}
/// Deletes a quick link.
Future<void> delete(String id) async {
try {
_safeSetState(const AsyncValue.loading());
final datasource = ref.read(quickLinksDatasourceProvider);
final intId = int.tryParse(id) ?? 0;
await datasource.deleteQuickLink(intId);
_safeInvalidate([quickLinksProvider]);
_safeSetState(const AsyncValue.data(null));
} catch (e, st) {
_safeSetState(AsyncValue.error(e, st));
}
}
/// Reorders quick links.
Future<void> reorder(List<String> orderedIds) async {
try {
_safeSetState(const AsyncValue.loading());
final datasource = ref.read(quickLinksDatasourceProvider);
final intIds = orderedIds.map((id) => int.tryParse(id) ?? 0).toList();
await datasource.reorderQuickLinks(intIds);
_safeInvalidate([quickLinksProvider]);
_safeSetState(const AsyncValue.data(null));
} catch (e, st) {
_safeSetState(AsyncValue.error(e, st));
}
}
}
/// Default seed data for quick links (used when API returns empty).
List<QuickLink> getDefaultQuickLinks() {
return [
// Home category
const QuickLink(
id: 'jellyfin',
name: 'Jellyfin',
url: 'https://jellyfin.schweitz.net',
iconName: 'movie',
category: 'Home',
type: QuickLinkType.iframe,
sortOrder: 0,
),
const QuickLink(
id: 'webui',
name: 'Open WebUI',
url: 'https://webui.schweitz.net',
iconName: 'chat',
category: 'Home',
type: QuickLinkType.iframe,
sortOrder: 1,
),
const QuickLink(
id: 'searxng',
name: 'SearXNG',
url: 'https://search.schweitz.net',
iconName: 'search',
category: 'Home',
type: QuickLinkType.newTab,
sortOrder: 2,
),
// AMP category
const QuickLink(
id: 'amp',
name: 'AMP Home',
url: 'https://amp.schweitz.net',
iconName: 'videogame_asset',
category: 'AMP',
type: QuickLinkType.newTab,
sortOrder: 0,
),
// Coding category
const QuickLink(
id: 'gitea',
name: 'Gitea',
url: 'https://git.schweitz.net',
iconName: 'code',
category: 'Coding',
type: QuickLinkType.iframe,
sortOrder: 0,
),
const QuickLink(
id: 'cloud-ide',
name: 'Cloud IDE',
url: 'https://code.schweitz.net',
iconName: 'terminal',
category: 'Coding',
type: QuickLinkType.newTab,
sortOrder: 1,
),
// Infrastructure category
const QuickLink(
id: 'netdata',
name: 'Netdata',
url: 'https://netdata.schweitz.net',
iconName: 'monitoring',
category: 'Infrastructure',
type: QuickLinkType.iframe,
sortOrder: 0,
),
const QuickLink(
id: 'portainer',
name: 'Portainer',
url: 'https://portainer.schweitz.net',
iconName: 'dns',
category: 'Infrastructure',
type: QuickLinkType.iframe,
sortOrder: 1,
),
const QuickLink(
id: 'npm',
name: 'Proxy Manager',
url: 'https://npm.schweitz.net',
iconName: 'public',
category: 'Infrastructure',
type: QuickLinkType.iframe,
sortOrder: 2,
),
const QuickLink(
id: 'core-api',
name: 'Core API',
url: 'https://api.schweitz.net/docs',
iconName: 'api',
category: 'Infrastructure',
type: QuickLinkType.iframe,
sortOrder: 3,
),
];
}
@@ -0,0 +1,14 @@
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/features/front_hall/data/models/system_stats_model.dart';
part 'system_stats_provider.g.dart';
/// Fetches system stats from Core API.
@riverpod
Future<SystemStats> systemStats(Ref ref) async {
final dio = ref.watch(coreApiClientProvider);
final response = await dio.get('/tools/system/stats');
return SystemStats.fromJson(response.data as Map<String, dynamic>);
}
@@ -0,0 +1,269 @@
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/data/models/system_stats_model.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/system_stats_provider.dart';
import 'package:tatlock_ui/shared/widgets/widgets.dart';
import 'package:tatlock_ui/version.g.dart';
/// Dashboard content shown in Front Hall when mode is dashboard.
///
/// Displays system stats with gauges, weather, air quality, and version info.
/// Auto-refreshes system stats every 30 seconds.
class DashboardContent extends ConsumerStatefulWidget {
const DashboardContent({super.key});
@override
ConsumerState<DashboardContent> createState() => _DashboardContentState();
}
class _DashboardContentState extends ConsumerState<DashboardContent> {
Timer? _refreshTimer;
@override
void initState() {
super.initState();
_refreshTimer = Timer.periodic(
const Duration(seconds: 30),
(_) => ref.invalidate(systemStatsProvider),
);
}
@override
void dispose() {
_refreshTimer?.cancel();
super.dispose();
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final systemStatsAsync = ref.watch(systemStatsProvider);
return ListView(
padding: const EdgeInsets.all(16),
children: [
// Welcome card
Card(
child: Padding(
padding: const EdgeInsets.all(24),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
Icon(
Icons.waving_hand,
size: 32,
color: colorScheme.primary,
),
const SizedBox(width: 12),
Flexible(
child: Text(
'Welcome to Tatlock',
style: Theme.of(context).textTheme.headlineSmall,
),
),
],
),
const SizedBox(height: 12),
Text(
'Your homelab dashboard is ready.',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
),
const SizedBox(height: 16),
// System Stats - Gauges
_SectionHeader(title: 'System Stats', icon: Icons.monitor_heart),
const SizedBox(height: 8),
systemStatsAsync.when(
data: (stats) => _SystemStatsCard(stats: stats),
loading: () => const Card(
child: Padding(
padding: EdgeInsets.all(32),
child: Center(child: CircularProgressIndicator()),
),
),
error: (error, _) => Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Icon(Icons.error_outline, color: colorScheme.error),
const SizedBox(width: 12),
Expanded(
child: Text(
'Failed to load system stats',
style: TextStyle(color: colorScheme.error),
),
),
IconButton(
icon: const Icon(Icons.refresh),
onPressed: () => ref.invalidate(systemStatsProvider),
),
],
),
),
),
),
const SizedBox(height: 24),
// Environment - Weather & Air Quality
_SectionHeader(title: 'Environment', icon: Icons.eco),
const SizedBox(height: 8),
LayoutBuilder(
builder: (context, constraints) {
// Responsive layout: side-by-side on wider screens
if (constraints.maxWidth > 500) {
return Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(child: WeatherWidget()),
const SizedBox(width: 12),
Expanded(child: AirQualityWidget()),
],
);
}
// Stack on narrow screens
return Column(
children: [
WeatherWidget(),
const SizedBox(height: 12),
AirQualityWidget(),
],
);
},
),
const SizedBox(height: 24),
// Version info
Center(
child: Text(
'${AppVersion.name} v${AppVersion.fullVersion}',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
),
),
),
],
);
}
}
/// Section header with icon and title.
class _SectionHeader extends StatelessWidget {
const _SectionHeader({
required this.title,
required this.icon,
});
final String title;
final IconData icon;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Row(
children: [
Icon(
icon,
size: 18,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
title,
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
fontWeight: FontWeight.w500,
),
),
],
);
}
}
/// Card displaying system stats with gauges.
class _SystemStatsCard extends StatelessWidget {
const _SystemStatsCard({required this.stats});
final SystemStats stats;
/// Pastel colors based on usage percentage.
static const _pastelGreen = Color(0xFF81C784);
static const _pastelOrange = Color(0xFFFFB74D);
static const _pastelRed = Color(0xFFE57373);
/// Returns color based on usage: green ≤50%, orange 51-75%, red >75%.
Color _colorForUsage(double percent) {
if (percent <= 50) return _pastelGreen;
if (percent <= 75) return _pastelOrange;
return _pastelRed;
}
@override
Widget build(BuildContext context) {
// Build gauges list: CPU, Memory, GPU (if available), then all disks
final gauges = <GaugeData>[
GaugeData(
value: stats.cpu.usagePercent / 100,
label: 'CPU',
icon: Icons.memory,
color: _colorForUsage(stats.cpu.usagePercent),
),
GaugeData(
value: stats.memory.usagePercent / 100,
label: 'RAM',
icon: Icons.storage,
color: _colorForUsage(stats.memory.usagePercent),
),
if (stats.gpu.available && stats.gpu.usagePercent != null)
GaugeData(
value: stats.gpu.usagePercent! / 100,
label: 'VRAM',
icon: Icons.videocam,
color: _colorForUsage(stats.gpu.usagePercent!),
),
// Add a gauge for each disk
...stats.disks.map(
(disk) => GaugeData(
value: disk.usagePercent / 100,
label: _formatDiskLabel(disk),
icon: Icons.disc_full,
color: _colorForUsage(disk.usagePercent),
),
),
];
return Card(
child: Padding(
padding: const EdgeInsets.all(24),
child: GaugeRow(
gaugeSize: 120,
gauges: gauges,
),
),
);
}
/// Formats disk label from mount point.
String _formatDiskLabel(DiskStats disk) {
final mount = disk.mountPoint;
if (mount == '/') return 'Root';
if (mount == '/hostfs') return 'Host';
if (mount.startsWith('/hostfs/')) return mount.substring(8);
if (mount.startsWith('/mnt/')) return mount.substring(5);
if (mount.startsWith('/media/')) return mount.substring(7);
// Return last path segment
final parts = mount.split('/');
return parts.isNotEmpty ? parts.last : mount;
}
}
@@ -0,0 +1,4 @@
// Conditional export for platform-specific iframe implementation.
// Web uses actual iframe embedding, other platforms open in browser.
export 'iframe_view_stub.dart'
if (dart.library.html) 'iframe_view_web.dart';
@@ -0,0 +1,83 @@
import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';
/// Stub implementation for non-web platforms.
///
/// Since iframes are web-only, this shows a message and offers
/// to open the link in an external browser.
class IframeView extends StatelessWidget {
const IframeView({
super.key,
required this.url,
required this.title,
required this.onClose,
});
final String url;
final String title;
final VoidCallback onClose;
Future<void> _openInBrowser() async {
final uri = Uri.tryParse(url);
if (uri != null && await canLaunchUrl(uri)) {
await launchUrl(uri, mode: LaunchMode.externalApplication);
}
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
// Auto-open in browser and show message
WidgetsBinding.instance.addPostFrameCallback((_) {
_openInBrowser();
});
return Center(
child: Padding(
padding: const EdgeInsets.all(32),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.open_in_browser,
size: 64,
color: colorScheme.primary,
),
const SizedBox(height: 16),
Text(
'Opening in Browser',
style: textTheme.titleLarge,
),
const SizedBox(height: 8),
Text(
'Embedded views are not supported on this platform.\n"$title" is opening in your browser.',
textAlign: TextAlign.center,
style: textTheme.bodyMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
const SizedBox(height: 24),
Row(
mainAxisSize: MainAxisSize.min,
children: [
OutlinedButton.icon(
onPressed: _openInBrowser,
icon: const Icon(Icons.open_in_new),
label: const Text('Open Again'),
),
const SizedBox(width: 12),
FilledButton.icon(
onPressed: onClose,
icon: const Icon(Icons.arrow_back),
label: const Text('Back to Dashboard'),
),
],
),
],
),
),
);
}
}
@@ -0,0 +1,144 @@
import 'dart:html' as html;
import 'dart:ui_web' as ui_web;
import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';
/// Embedded iframe view for displaying external content (web only).
///
/// Uses HtmlElementView for Flutter web to embed an iframe.
/// Includes a header bar with title, refresh, open in new tab, and close actions.
class IframeView extends StatefulWidget {
const IframeView({
super.key,
required this.url,
required this.title,
required this.onClose,
});
/// URL to display in the iframe.
final String url;
/// Title displayed in the header bar.
final String title;
/// Callback when the close button is pressed.
final VoidCallback onClose;
@override
State<IframeView> createState() => _IframeViewState();
}
class _IframeViewState extends State<IframeView> {
late final String _viewType;
late html.IFrameElement _iframe;
bool _isLoading = true;
@override
void initState() {
super.initState();
_viewType = 'iframe-${widget.url.hashCode}-${DateTime.now().millisecondsSinceEpoch}';
_createIframe();
}
void _createIframe() {
_iframe = html.IFrameElement()
..src = widget.url
..style.border = 'none'
..style.width = '100%'
..style.height = '100%'
..allow = 'fullscreen'
..onLoad.listen((_) {
if (mounted) {
setState(() => _isLoading = false);
}
});
// Register the view factory
ui_web.platformViewRegistry.registerViewFactory(
_viewType,
(int viewId) => _iframe,
);
}
void _refresh() {
setState(() => _isLoading = true);
// Reload the iframe by setting src again
_iframe.src = widget.url;
}
Future<void> _openInNewTab() async {
final uri = Uri.tryParse(widget.url);
if (uri != null && await canLaunchUrl(uri)) {
await launchUrl(uri, mode: LaunchMode.externalApplication);
}
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Column(
children: [
// Header bar
Container(
height: 56,
padding: const EdgeInsets.symmetric(horizontal: 16),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
border: Border(
bottom: BorderSide(color: colorScheme.outlineVariant),
),
),
child: Row(
children: [
// Title
Expanded(
child: Text(
widget.title,
style: textTheme.titleSmall?.copyWith(
fontWeight: FontWeight.w600,
),
overflow: TextOverflow.ellipsis,
),
),
// Actions
IconButton(
icon: const Icon(Icons.open_in_new, size: 20),
tooltip: 'Open in new tab',
onPressed: _openInNewTab,
),
IconButton(
icon: const Icon(Icons.refresh, size: 20),
tooltip: 'Refresh',
onPressed: _refresh,
),
IconButton(
icon: const Icon(Icons.close, size: 20),
tooltip: 'Close',
onPressed: widget.onClose,
),
],
),
),
// Iframe content
Expanded(
child: Stack(
children: [
HtmlElementView(viewType: _viewType),
// Loading overlay
if (_isLoading)
Container(
color: colorScheme.surface,
child: const Center(
child: CircularProgressIndicator(),
),
),
],
),
),
],
);
}
}
@@ -0,0 +1,343 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/domain/entities/quick_link.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/quick_links_provider.dart';
import 'package:tatlock_ui/shared/widgets/entity_page.dart';
import 'package:tatlock_ui/shared/widgets/icon_picker.dart';
/// Form for creating and editing Quick Links.
///
/// Handles validation, submission, and state management for link data.
class QuickLinkForm extends ConsumerStatefulWidget {
const QuickLinkForm({
super.key,
required this.mode,
this.quickLink,
required this.onCancel,
required this.onSaved,
});
final EntityPageMode mode;
final QuickLink? quickLink;
final VoidCallback onCancel;
final VoidCallback onSaved;
@override
ConsumerState<QuickLinkForm> createState() => _QuickLinkFormState();
}
class _QuickLinkFormState extends ConsumerState<QuickLinkForm> {
final _formKey = GlobalKey<FormState>();
late final TextEditingController _nameController;
late final TextEditingController _urlController;
late final TextEditingController _categoryController;
late String _iconName;
late QuickLinkType _type;
late bool _isActive;
bool _isSubmitting = false;
@override
void initState() {
super.initState();
final link = widget.quickLink;
_nameController = TextEditingController(text: link?.name ?? '');
_urlController = TextEditingController(text: link?.url ?? '');
_categoryController = TextEditingController(text: link?.category ?? '');
_iconName = link?.iconName ?? 'link';
_type = link?.type ?? QuickLinkType.iframe;
_isActive = link?.isActive ?? true;
}
@override
void dispose() {
_nameController.dispose();
_urlController.dispose();
_categoryController.dispose();
super.dispose();
}
bool get isCreate => widget.mode == EntityPageMode.create;
Future<void> _handleSubmit() async {
if (!_formKey.currentState!.validate()) return;
setState(() => _isSubmitting = true);
try {
final actions = ref.read(quickLinkActionsProvider.notifier);
final category = _categoryController.text.trim();
final QuickLink link;
if (isCreate) {
// Create new entity
link = QuickLink(
id: _nameController.text.toLowerCase().replaceAll(RegExp(r'\s+'), '-'),
name: _nameController.text.trim(),
url: _urlController.text.trim(),
iconName: _iconName,
category: category.isEmpty ? null : category,
type: _type,
isActive: _isActive,
sortOrder: 0,
);
await actions.create(link);
if (mounted) {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(
content: Text('Link created successfully'),
behavior: SnackBarBehavior.floating,
),
);
}
} else {
// Update: use copyWith to preserve all existing data
link = widget.quickLink!.copyWith(
name: _nameController.text.trim(),
url: _urlController.text.trim(),
iconName: _iconName,
category: category.isEmpty ? null : category,
type: _type,
isActive: _isActive,
);
await actions.update(link);
if (mounted) {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(
content: Text('Link updated successfully'),
behavior: SnackBarBehavior.floating,
),
);
}
}
// Refresh the list before exiting
ref.invalidate(quickLinksProvider);
widget.onSaved();
} catch (e) {
if (mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Error: $e'),
behavior: SnackBarBehavior.floating,
backgroundColor: Theme.of(context).colorScheme.error,
),
);
}
} finally {
if (mounted) {
setState(() => _isSubmitting = false);
}
}
}
Future<void> _handleDelete() async {
if (widget.quickLink == null) return;
final confirm = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
title: const Text('Delete Link'),
content: Text('Are you sure you want to delete "${widget.quickLink!.name}"?'),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(false),
child: const Text('Cancel'),
),
FilledButton(
onPressed: () => Navigator.of(context).pop(true),
style: FilledButton.styleFrom(
backgroundColor: Theme.of(context).colorScheme.error,
),
child: const Text('Delete'),
),
],
),
);
if (confirm == true) {
setState(() => _isSubmitting = true);
try {
await ref.read(quickLinkActionsProvider.notifier).delete(widget.quickLink!.id);
if (mounted) {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(
content: Text('Link deleted'),
behavior: SnackBarBehavior.floating,
),
);
widget.onSaved();
}
} catch (e) {
if (mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Error deleting: $e'),
behavior: SnackBarBehavior.floating,
backgroundColor: Theme.of(context).colorScheme.error,
),
);
}
} finally {
if (mounted) {
setState(() => _isSubmitting = false);
}
}
}
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Form(
key: _formKey,
child: ListView(
padding: const EdgeInsets.all(24),
children: [
// Name field
TextFormField(
controller: _nameController,
decoration: const InputDecoration(
labelText: 'Name',
hintText: 'Enter link name',
border: OutlineInputBorder(),
),
validator: (value) {
if (value == null || value.trim().isEmpty) {
return 'Name is required';
}
return null;
},
textInputAction: TextInputAction.next,
),
const SizedBox(height: 16),
// URL field
TextFormField(
controller: _urlController,
decoration: const InputDecoration(
labelText: 'URL',
hintText: 'https://example.com',
border: OutlineInputBorder(),
),
validator: (value) {
if (value == null || value.trim().isEmpty) {
return 'URL is required';
}
final uri = Uri.tryParse(value);
if (uri == null || !uri.hasScheme) {
return 'Enter a valid URL with scheme (http/https)';
}
return null;
},
keyboardType: TextInputType.url,
textInputAction: TextInputAction.next,
),
const SizedBox(height: 16),
// Category field
TextFormField(
controller: _categoryController,
decoration: const InputDecoration(
labelText: 'Category',
hintText: 'e.g., Home, Infrastructure, Coding',
border: OutlineInputBorder(),
),
textInputAction: TextInputAction.done,
),
const SizedBox(height: 24),
// Icon picker
IconPicker(
selectedIcon: _iconName,
onChanged: (icon) => setState(() => _iconName = icon),
),
const SizedBox(height: 24),
// Link type
Text(
'Link Type',
style: Theme.of(context).textTheme.labelMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
const SizedBox(height: 8),
SegmentedButton<QuickLinkType>(
segments: const [
ButtonSegment(
value: QuickLinkType.iframe,
icon: Icon(Icons.web),
label: Text('Iframe'),
),
ButtonSegment(
value: QuickLinkType.newTab,
icon: Icon(Icons.open_in_new),
label: Text('New Tab'),
),
],
selected: {_type},
onSelectionChanged: (selected) {
setState(() => _type = selected.first);
},
),
const SizedBox(height: 8),
Text(
_type == QuickLinkType.iframe
? 'Opens embedded in the dashboard'
: 'Opens in a new browser tab',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
),
),
const SizedBox(height: 24),
// Active toggle
SwitchListTile(
title: const Text('Active'),
subtitle: const Text('Show this link in the panel'),
value: _isActive,
onChanged: (value) => setState(() => _isActive = value),
contentPadding: EdgeInsets.zero,
),
const SizedBox(height: 32),
// Action buttons
Row(
children: [
if (!isCreate) ...[
OutlinedButton.icon(
onPressed: _isSubmitting ? null : _handleDelete,
style: OutlinedButton.styleFrom(
foregroundColor: colorScheme.error,
),
icon: const Icon(Icons.delete),
label: const Text('Delete'),
),
const Spacer(),
] else
const Spacer(),
TextButton(
onPressed: _isSubmitting ? null : widget.onCancel,
child: const Text('Cancel'),
),
const SizedBox(width: 8),
FilledButton(
onPressed: _isSubmitting ? null : _handleSubmit,
child: _isSubmitting
? const SizedBox(
width: 20,
height: 20,
child: CircularProgressIndicator(strokeWidth: 2),
)
: Text(isCreate ? 'Create' : 'Save'),
),
],
),
],
),
);
}
}
@@ -0,0 +1,147 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/front_hall_state_provider.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/quick_links_provider.dart';
import 'package:tatlock_ui/features/front_hall/presentation/widgets/quick_link_form.dart';
import 'package:tatlock_ui/shared/widgets/entity_page.dart';
/// Settings content for Quick Link management.
///
/// Shows either:
/// - Create form (when isCreating state is set)
/// - Edit form (when a link is selected)
/// - Empty state with "Add New Link" prompt (when no link selected)
class QuickLinkSettingsContent extends ConsumerStatefulWidget {
const QuickLinkSettingsContent({super.key});
@override
ConsumerState<QuickLinkSettingsContent> createState() =>
_QuickLinkSettingsContentState();
}
class _QuickLinkSettingsContentState
extends ConsumerState<QuickLinkSettingsContent> {
bool _isCreating = false;
void _startCreating() {
setState(() => _isCreating = true);
// Clear any selected link when creating new
ref.read(frontHallStateProvider.notifier).clearSelectedLink();
}
void _stopCreating() {
setState(() => _isCreating = false);
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
final frontHallState = ref.watch(frontHallStateProvider);
final selectedLinkId = frontHallState.selectedLinkId;
// Create mode - show create form
if (_isCreating) {
return Scaffold(
appBar: AppBar(
leading: IconButton(
icon: const Icon(Icons.arrow_back),
onPressed: _stopCreating,
),
title: const Text('Create New Link'),
),
body: QuickLinkForm(
mode: EntityPageMode.create,
onCancel: _stopCreating,
onSaved: () =>
ref.read(frontHallStateProvider.notifier).exitSettings(),
),
);
}
// No link selected - show empty state
if (selectedLinkId == null) {
return Center(
child: Padding(
padding: const EdgeInsets.all(32),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.add_link,
size: 64,
color: colorScheme.outline,
),
const SizedBox(height: 16),
Text(
'No link selected',
style: textTheme.titleLarge?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
const SizedBox(height: 8),
Text(
'Select a link from the panel to edit, or create a new one.',
textAlign: TextAlign.center,
style: textTheme.bodyMedium?.copyWith(
color: colorScheme.outline,
),
),
const SizedBox(height: 24),
FilledButton.icon(
onPressed: _startCreating,
icon: const Icon(Icons.add),
label: const Text('Create New Link'),
),
],
),
),
);
}
// Link selected - show edit form
final linkAsync = ref.watch(quickLinkProvider(selectedLinkId));
return linkAsync.when(
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, _) => Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(Icons.error_outline, size: 48, color: colorScheme.error),
const SizedBox(height: 16),
Text('Error loading link: $error'),
const SizedBox(height: 16),
TextButton.icon(
onPressed: () =>
ref.invalidate(quickLinkProvider(selectedLinkId)),
icon: const Icon(Icons.refresh),
label: const Text('Retry'),
),
],
),
),
data: (link) => Scaffold(
appBar: AppBar(
leading: IconButton(
icon: const Icon(Icons.arrow_back),
onPressed: () => ref
.read(frontHallStateProvider.notifier)
.clearSelectedLink(),
),
title: Text('Edit: ${link.name}'),
),
body: QuickLinkForm(
key: ValueKey(link.id), // Force recreation when link changes
mode: EntityPageMode.edit,
quickLink: link,
onCancel: () => ref
.read(frontHallStateProvider.notifier)
.clearSelectedLink(),
onSaved: () =>
ref.read(frontHallStateProvider.notifier).exitSettings(),
),
),
);
}
}
@@ -0,0 +1,683 @@
import 'dart:ui' show lerpDouble;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/domain/entities/quick_link.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/front_hall_state_provider.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/quick_links_provider.dart';
import 'package:tatlock_ui/shared/layouts/widgets/panel_header.dart';
import 'package:tatlock_ui/shared/widgets/icon_picker.dart';
import 'package:url_launcher/url_launcher.dart';
/// Left-side panel for quick link navigation in Front Hall.
///
/// Shows categorized links that can open in iframe or new tab.
/// Adapts behavior based on current mode (normal vs settings).
class QuickLinksPanel extends ConsumerWidget {
const QuickLinksPanel({
super.key,
this.width = 280,
});
final double width;
@override
Widget build(BuildContext context, WidgetRef ref) {
final colorScheme = Theme.of(context).colorScheme;
final frontHallState = ref.watch(frontHallStateProvider);
final quickLinksAsync = ref.watch(quickLinksProvider);
final isSettingsMode = frontHallState.mode == FrontHallMode.settings;
return SizedBox(
width: width,
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
// Header changes based on mode
if (isSettingsMode)
_SettingsModeHeader(
onBack: () =>
ref.read(frontHallStateProvider.notifier).exitSettings(),
)
else
PanelHeader(
title: 'Quick Links',
icon: Icons.link,
dockToBottom: true,
actions: [
IconButton(
icon: const Icon(Icons.refresh, size: 20),
tooltip: 'Refresh',
onPressed: () => ref.invalidate(quickLinksProvider),
padding: EdgeInsets.zero,
constraints: const BoxConstraints(),
),
],
),
// Add new link button (settings mode only)
if (isSettingsMode) ...[
Padding(
padding: const EdgeInsets.all(8),
child: FilledButton.icon(
onPressed: () => ref
.read(frontHallStateProvider.notifier)
.clearSelectedLink(),
icon: const Icon(Icons.add, size: 18),
label: const Text('Add New Link'),
),
),
Divider(height: 1, color: colorScheme.outlineVariant),
],
// Links list
Expanded(
child: quickLinksAsync.when(
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, _) => _ErrorState(
error: error,
onRetry: () => ref.invalidate(quickLinksProvider),
),
data: (links) {
// Use default links if empty
final displayLinks =
links.isEmpty ? getDefaultQuickLinks() : links;
return _QuickLinksList(
links: displayLinks,
selectedLinkId: frontHallState.selectedLinkId,
isSettingsMode: isSettingsMode,
);
},
),
),
// Settings button (normal mode only)
if (!isSettingsMode) ...[
Divider(height: 1, color: colorScheme.outlineVariant),
Padding(
padding: const EdgeInsets.all(8),
child: TextButton.icon(
onPressed: () => ref
.read(frontHallStateProvider.notifier)
.enterSettings(),
icon: const Icon(Icons.settings, size: 18),
label: const Text('Settings'),
),
),
],
],
),
);
}
}
/// Header for settings mode with back button.
class _SettingsModeHeader extends StatelessWidget {
const _SettingsModeHeader({required this.onBack});
final VoidCallback onBack;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Container(
height: 56,
padding: const EdgeInsets.symmetric(horizontal: 8),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
border: Border(
bottom: BorderSide(color: colorScheme.outlineVariant),
),
),
child: Row(
children: [
IconButton(
icon: const Icon(Icons.arrow_back),
tooltip: 'Back to Dashboard',
onPressed: onBack,
),
const SizedBox(width: 4),
Icon(Icons.link, size: 20, color: colorScheme.primary),
const SizedBox(width: 8),
Text(
'Quick Links',
style: textTheme.titleSmall?.copyWith(
fontWeight: FontWeight.w600,
),
),
],
),
);
}
}
/// List of quick links grouped by category.
///
/// In settings mode, shows a flat reorderable list.
/// In normal mode, shows grouped list with category headers.
class _QuickLinksList extends ConsumerWidget {
const _QuickLinksList({
required this.links,
required this.selectedLinkId,
required this.isSettingsMode,
});
final List<QuickLink> links;
final String? selectedLinkId;
final bool isSettingsMode;
/// Groups links by category, preserving order.
List<(String?, List<QuickLink>)> get _groupedLinks {
final groups = <String?, List<QuickLink>>{};
final order = <String?>[];
for (final link in links) {
if (!groups.containsKey(link.category)) {
groups[link.category] = [];
order.add(link.category);
}
groups[link.category]!.add(link);
}
return order.map((category) => (category, groups[category]!)).toList();
}
bool get _showCategoryHeaders {
final categories =
links.map((l) => l.category).where((c) => c != null).toSet();
return categories.length > 1;
}
@override
Widget build(BuildContext context, WidgetRef ref) {
// In settings mode, show reorderable list
if (isSettingsMode) {
return _buildReorderableList(context, ref);
}
// In normal mode, show grouped list
return ListView(
padding: const EdgeInsets.symmetric(vertical: 8),
children: _buildLinkList(context, ref),
);
}
Widget _buildReorderableList(BuildContext context, WidgetRef ref) {
return ReorderableListView.builder(
padding: const EdgeInsets.symmetric(vertical: 8),
itemCount: links.length,
onReorder: (oldIndex, newIndex) => _handleReorder(ref, oldIndex, newIndex),
proxyDecorator: (child, index, animation) {
return AnimatedBuilder(
animation: animation,
builder: (context, child) {
final elevation = lerpDouble(0, 8, animation.value) ?? 0;
return Material(
elevation: elevation,
borderRadius: BorderRadius.circular(8),
child: child,
);
},
child: child,
);
},
itemBuilder: (context, index) {
final link = links[index];
return _ReorderableLinkTile(
key: ValueKey(link.id),
link: link,
index: index,
isSelected: link.id == selectedLinkId,
onTap: () => _handleLinkTap(ref, link),
onEdit: () => ref
.read(frontHallStateProvider.notifier)
.selectLink(link.id),
onDelete: () => _handleDelete(context, ref, link),
);
},
);
}
void _handleReorder(WidgetRef ref, int oldIndex, int newIndex) {
// Adjust for the removal
if (newIndex > oldIndex) {
newIndex -= 1;
}
// Create new ordered list
final reorderedLinks = List<QuickLink>.from(links);
final item = reorderedLinks.removeAt(oldIndex);
reorderedLinks.insert(newIndex, item);
// Extract IDs in new order
final orderedIds = reorderedLinks.map((l) => l.id).toList();
// Call reorder API
ref.read(quickLinkActionsProvider.notifier).reorder(orderedIds);
}
List<Widget> _buildLinkList(BuildContext context, WidgetRef ref) {
final widgets = <Widget>[];
final showHeaders = _showCategoryHeaders;
for (final (category, categoryLinks) in _groupedLinks) {
// Add category header if multiple categories exist
if (showHeaders && category != null) {
widgets.add(_CategoryHeader(title: category));
}
// Add links
for (final link in categoryLinks) {
widgets.add(
_QuickLinkTile(
link: link,
isSelected: link.id == selectedLinkId,
isSettingsMode: isSettingsMode,
onTap: () => _handleLinkTap(ref, link),
onEdit: isSettingsMode
? () => ref
.read(frontHallStateProvider.notifier)
.selectLink(link.id)
: null,
onDelete: isSettingsMode
? () => _handleDelete(context, ref, link)
: null,
),
);
}
}
return widgets;
}
void _handleLinkTap(WidgetRef ref, QuickLink link) {
if (isSettingsMode) {
// In settings mode, select link for editing
ref.read(frontHallStateProvider.notifier).selectLink(link.id);
} else {
// Close any open content first to ensure clean state
ref.read(frontHallStateProvider.notifier).showDashboard();
// Then open the new link
if (link.isIframe) {
ref
.read(frontHallStateProvider.notifier)
.showIframe(link.url, link.name);
} else {
// Open in new tab
_openInNewTab(link.url);
}
}
}
Future<void> _openInNewTab(String url) async {
final uri = Uri.tryParse(url);
if (uri != null && await canLaunchUrl(uri)) {
await launchUrl(uri, mode: LaunchMode.externalApplication);
}
}
Future<void> _handleDelete(
BuildContext context,
WidgetRef ref,
QuickLink link,
) async {
final confirmed = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
title: const Text('Delete Link'),
content: Text('Delete "${link.name}"?'),
actions: [
TextButton(
onPressed: () => Navigator.pop(context, false),
child: const Text('Cancel'),
),
FilledButton(
onPressed: () => Navigator.pop(context, true),
child: const Text('Delete'),
),
],
),
);
if (confirmed == true) {
await ref.read(quickLinkActionsProvider.notifier).delete(link.id);
}
}
}
/// Reorderable link tile with drag handle for settings mode.
class _ReorderableLinkTile extends StatelessWidget {
const _ReorderableLinkTile({
super.key,
required this.link,
required this.index,
required this.isSelected,
required this.onTap,
required this.onEdit,
required this.onDelete,
});
final QuickLink link;
final int index;
final bool isSelected;
final VoidCallback onTap;
final VoidCallback onEdit;
final VoidCallback onDelete;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
child: Material(
color: isSelected
? colorScheme.primaryContainer.withValues(alpha: 0.4)
: Colors.transparent,
borderRadius: BorderRadius.circular(8),
child: InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(8),
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 10),
child: Row(
children: [
// Drag handle
ReorderableDragStartListener(
index: index,
child: MouseRegion(
cursor: SystemMouseCursors.grab,
child: Icon(
Icons.drag_indicator,
size: 20,
color: colorScheme.outline,
),
),
),
const SizedBox(width: 8),
// Icon
Icon(
getIconData(link.iconName),
size: 20,
color: isSelected
? colorScheme.primary
: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 12),
// Name and subtitle
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
link.name,
style: textTheme.bodyMedium?.copyWith(
color: isSelected
? colorScheme.primary
: colorScheme.onSurface,
fontWeight: isSelected ? FontWeight.w600 : null,
),
),
Text(
link.category ?? 'No category',
style: textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
fontSize: 11,
),
),
],
),
),
// Overflow menu
PopupMenuButton<String>(
icon: Icon(
Icons.more_vert,
size: 18,
color: colorScheme.onSurfaceVariant,
),
padding: EdgeInsets.zero,
itemBuilder: (context) => [
const PopupMenuItem(
value: 'edit',
child: Row(
children: [
Icon(Icons.edit, size: 18),
SizedBox(width: 8),
Text('Edit'),
],
),
),
const PopupMenuItem(
value: 'delete',
child: Row(
children: [
Icon(Icons.delete, size: 18),
SizedBox(width: 8),
Text('Delete'),
],
),
),
],
onSelected: (value) {
switch (value) {
case 'edit':
onEdit();
case 'delete':
onDelete();
}
},
),
],
),
),
),
),
);
}
}
/// Category header with left accent bar.
class _CategoryHeader extends StatelessWidget {
const _CategoryHeader({required this.title});
final String title;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Container(
margin: const EdgeInsets.only(top: 8, bottom: 4),
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 6),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHigh,
border: Border(
left: BorderSide(
color: colorScheme.primary,
width: 2,
),
),
),
child: Text(
title.toUpperCase(),
style: textTheme.labelSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
letterSpacing: 0.5,
fontWeight: FontWeight.w600,
),
),
);
}
}
/// Individual quick link tile.
class _QuickLinkTile extends StatelessWidget {
const _QuickLinkTile({
required this.link,
required this.isSelected,
required this.isSettingsMode,
required this.onTap,
this.onEdit,
this.onDelete,
});
final QuickLink link;
final bool isSelected;
final bool isSettingsMode;
final VoidCallback onTap;
final VoidCallback? onEdit;
final VoidCallback? onDelete;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
child: Material(
color: isSelected
? colorScheme.primaryContainer.withValues(alpha: 0.4)
: Colors.transparent,
borderRadius: BorderRadius.circular(8),
child: InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(8),
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 10),
child: Row(
children: [
Icon(
getIconData(link.iconName),
size: 20,
color: isSelected
? colorScheme.primary
: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 12),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
link.name,
style: textTheme.bodyMedium?.copyWith(
color:
isSelected ? colorScheme.primary : colorScheme.onSurface,
fontWeight: isSelected ? FontWeight.w600 : null,
),
),
if (isSettingsMode)
Text(
link.isNewTab ? 'Opens in new tab' : 'Opens in iframe',
style: textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
fontSize: 11,
),
),
],
),
),
// New tab indicator (normal mode)
if (!isSettingsMode && link.isNewTab)
Icon(
Icons.open_in_new,
size: 14,
color: colorScheme.outline,
),
// Overflow menu (settings mode)
if (isSettingsMode)
PopupMenuButton<String>(
icon: Icon(
Icons.more_vert,
size: 18,
color: colorScheme.onSurfaceVariant,
),
padding: EdgeInsets.zero,
itemBuilder: (context) => [
const PopupMenuItem(
value: 'edit',
child: Row(
children: [
Icon(Icons.edit, size: 18),
SizedBox(width: 8),
Text('Edit'),
],
),
),
const PopupMenuItem(
value: 'delete',
child: Row(
children: [
Icon(Icons.delete, size: 18),
SizedBox(width: 8),
Text('Delete'),
],
),
),
],
onSelected: (value) {
switch (value) {
case 'edit':
onEdit?.call();
case 'delete':
onDelete?.call();
}
},
),
],
),
),
),
),
);
}
}
/// Error state widget.
class _ErrorState extends StatelessWidget {
const _ErrorState({
required this.error,
required this.onRetry,
});
final Object error;
final VoidCallback onRetry;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Center(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.error_outline,
color: colorScheme.error,
size: 32,
),
const SizedBox(height: 8),
Text(
'Failed to load links',
style: TextStyle(color: colorScheme.error),
),
const SizedBox(height: 8),
TextButton.icon(
onPressed: onRetry,
icon: const Icon(Icons.refresh, size: 16),
label: const Text('Retry'),
),
],
),
),
);
}
}
+12 -2
View File
@@ -103,9 +103,19 @@ class DataGrid<T> extends ConsumerWidget {
DataGridState<T> state,
DataGridController<T> controller,
) {
return Padding(
padding: const EdgeInsets.all(16),
final colorScheme = Theme.of(context).colorScheme;
return Container(
height: 56,
padding: const EdgeInsets.symmetric(horizontal: 16),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
border: Border(
bottom: BorderSide(color: colorScheme.outlineVariant),
),
),
child: Row(
crossAxisAlignment: CrossAxisAlignment.center,
children: [
if (config.enableSearch)
DataGridSearchBar(
@@ -35,6 +35,9 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
/// Debounce timer for search.
Timer? _searchDebounce;
/// All items before local filtering (for local search).
List<T> _allItems = [];
@override
void dispose() {
_searchDebounce?.cancel();
@@ -57,16 +60,21 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
final (offset, limit) = _getPaginationParams();
final result = await source.fetch(
searchQuery: state.searchQuery.isEmpty ? null : state.searchQuery,
sortField: sortField,
sortDescending: state.sortDescending,
offset: offset,
limit: limit,
);
// Store all items for local filtering
_allItems = result.items;
// Apply local filter if search query exists
final filteredItems = _applyLocalFilter(_allItems);
state = state.copyWith(
items: result.items,
totalCount: result.totalCount,
items: filteredItems,
totalCount: filteredItems.length,
hasMore: result.hasMore,
isLoading: false,
isInitialLoad: false,
@@ -82,6 +90,26 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
}
}
/// Applies local filtering based on search query.
List<T> _applyLocalFilter(List<T> items) {
if (state.searchQuery.isEmpty) return items;
final query = state.searchQuery.toLowerCase();
return items.where((item) {
// Check all searchable columns
for (final column in config.columns) {
if (column.searchable) {
final value = column.valueBuilder(item);
if (value.toLowerCase().contains(query)) {
return true;
}
}
}
return false;
}).toList();
}
/// Gets pagination parameters based on data mode.
(int?, int?) _getPaginationParams() {
return switch (config.dataMode) {
@@ -97,13 +125,13 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
/// Refreshes the grid data.
Future<void> refresh() => _load(refresh: true);
/// Sets the search query with debouncing.
/// Sets the search query with debouncing (filters locally).
void search(String query) {
_searchDebounce?.cancel();
_searchDebounce = Timer(const Duration(milliseconds: 300), () {
_searchDebounce = Timer(const Duration(milliseconds: 150), () {
if (state.searchQuery != query) {
state = state.copyWith(searchQuery: query, currentPage: 0);
_load(refresh: true);
_applyFilterAndUpdateState();
}
});
}
@@ -113,10 +141,19 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
_searchDebounce?.cancel();
if (state.searchQuery.isNotEmpty) {
state = state.copyWith(searchQuery: '', currentPage: 0);
_load(refresh: true);
_applyFilterAndUpdateState();
}
}
/// Applies local filter and updates state with filtered items.
void _applyFilterAndUpdateState() {
final filteredItems = _applyLocalFilter(_allItems);
state = state.copyWith(
items: filteredItems,
totalCount: filteredItems.length,
);
}
/// Sorts by the given column index.
void sortBy(int columnIndex) {
final column = config.columns[columnIndex];
@@ -40,14 +40,16 @@ class _DataGridSearchBarState extends State<DataGridSearchBar> {
return SizedBox(
width: 300,
height: 36,
child: TextField(
controller: _controller,
style: const TextStyle(fontSize: 14),
decoration: InputDecoration(
hintText: widget.hintText,
prefixIcon: const Icon(Icons.search),
prefixIcon: const Icon(Icons.search, size: 20),
suffixIcon: _controller.text.isNotEmpty
? IconButton(
icon: const Icon(Icons.clear),
icon: const Icon(Icons.clear, size: 18),
onPressed: () {
_controller.clear();
widget.onClear();
@@ -56,14 +58,22 @@ class _DataGridSearchBarState extends State<DataGridSearchBar> {
: null,
isDense: true,
filled: true,
fillColor: colorScheme.surfaceContainerHighest,
fillColor: colorScheme.surface,
border: OutlineInputBorder(
borderRadius: BorderRadius.circular(8),
borderSide: BorderSide.none,
borderSide: BorderSide(color: colorScheme.outlineVariant),
),
enabledBorder: OutlineInputBorder(
borderRadius: BorderRadius.circular(8),
borderSide: BorderSide(color: colorScheme.outlineVariant),
),
focusedBorder: OutlineInputBorder(
borderRadius: BorderRadius.circular(8),
borderSide: BorderSide(color: colorScheme.primary),
),
contentPadding: const EdgeInsets.symmetric(
horizontal: 16,
vertical: 12,
horizontal: 12,
vertical: 8,
),
),
onChanged: (value) {
+316
View File
@@ -0,0 +1,316 @@
import 'package:flutter/material.dart';
/// Air Quality Index widget displaying current AQI.
///
/// Currently uses mock data. Will be connected to air quality API in future.
class AirQualityWidget extends StatelessWidget {
const AirQualityWidget({
super.key,
this.data,
this.compact = false,
});
/// Air quality data to display. Uses mock data if null.
final AirQualityData? data;
/// Whether to use compact layout.
final bool compact;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final aqi = data ?? AirQualityData.mock();
if (compact) {
return _buildCompact(context, colorScheme, aqi);
}
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
Icons.air,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
'Air Quality',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
const SizedBox(height: 16),
// AQI Display
Row(
children: [
// AQI number with colored background
Container(
width: 64,
height: 64,
decoration: BoxDecoration(
color: aqi.level.color.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(12),
border: Border.all(
color: aqi.level.color.withValues(alpha: 0.3),
width: 2,
),
),
child: Center(
child: Text(
'${aqi.index}',
style:
Theme.of(context).textTheme.headlineMedium?.copyWith(
fontWeight: FontWeight.bold,
color: aqi.level.color,
),
),
),
),
const SizedBox(width: 16),
// Level info
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
aqi.level.label,
style:
Theme.of(context).textTheme.titleMedium?.copyWith(
fontWeight: FontWeight.w600,
color: aqi.level.color,
),
),
const SizedBox(height: 4),
Text(
aqi.level.description,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
maxLines: 2,
overflow: TextOverflow.ellipsis,
),
],
),
),
],
),
// Pollutants
if (aqi.pollutants.isNotEmpty) ...[
const SizedBox(height: 16),
const Divider(height: 1),
const SizedBox(height: 12),
Wrap(
spacing: 16,
runSpacing: 8,
children: aqi.pollutants
.map((p) => _PollutantChip(pollutant: p))
.toList(),
),
],
],
),
),
);
}
Widget _buildCompact(
BuildContext context,
ColorScheme colorScheme,
AirQualityData aqi,
) {
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Container(
width: 32,
height: 32,
decoration: BoxDecoration(
color: aqi.level.color.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(6),
),
child: Center(
child: Text(
'${aqi.index}',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
fontWeight: FontWeight.bold,
color: aqi.level.color,
),
),
),
),
const SizedBox(width: 8),
Text(
'AQI',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
);
}
}
class _PollutantChip extends StatelessWidget {
const _PollutantChip({required this.pollutant});
final Pollutant pollutant;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Row(
mainAxisSize: MainAxisSize.min,
children: [
Text(
pollutant.name,
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: colorScheme.outline,
),
),
const SizedBox(width: 4),
Text(
'${pollutant.value.round()} ${pollutant.unit}',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
fontWeight: FontWeight.w500,
),
),
],
);
}
}
/// Air Quality Index levels based on US EPA standard.
enum AqiLevel {
good(
label: 'Good',
description: 'Air quality is satisfactory',
color: Colors.green,
minIndex: 0,
maxIndex: 50,
),
moderate(
label: 'Moderate',
description: 'Acceptable for most people',
color: Colors.amber,
minIndex: 51,
maxIndex: 100,
),
unhealthySensitive(
label: 'Unhealthy for Sensitive',
description: 'May affect sensitive groups',
color: Colors.orange,
minIndex: 101,
maxIndex: 150,
),
unhealthy(
label: 'Unhealthy',
description: 'Health effects for everyone',
color: Colors.red,
minIndex: 151,
maxIndex: 200,
),
veryUnhealthy(
label: 'Very Unhealthy',
description: 'Serious health effects',
color: Color(0xFF8B008B),
minIndex: 201,
maxIndex: 300,
),
hazardous(
label: 'Hazardous',
description: 'Health emergency conditions',
color: Color(0xFF800000),
minIndex: 301,
maxIndex: 500,
);
const AqiLevel({
required this.label,
required this.description,
required this.color,
required this.minIndex,
required this.maxIndex,
});
final String label;
final String description;
final Color color;
final int minIndex;
final int maxIndex;
static AqiLevel fromIndex(int index) {
for (final level in AqiLevel.values) {
if (index >= level.minIndex && index <= level.maxIndex) {
return level;
}
}
return AqiLevel.hazardous;
}
}
/// Pollutant data.
class Pollutant {
const Pollutant({
required this.name,
required this.value,
required this.unit,
});
final String name;
final double value;
final String unit;
}
/// Air quality data model.
class AirQualityData {
const AirQualityData({
required this.index,
required this.level,
this.pollutants = const [],
});
final int index;
final AqiLevel level;
final List<Pollutant> pollutants;
/// Create from index value.
factory AirQualityData.fromIndex(int index, {List<Pollutant>? pollutants}) {
return AirQualityData(
index: index,
level: AqiLevel.fromIndex(index),
pollutants: pollutants ?? const [],
);
}
/// Mock air quality data for development.
factory AirQualityData.mock() {
return const AirQualityData(
index: 42,
level: AqiLevel.good,
pollutants: [
Pollutant(name: 'PM2.5', value: 8.5, unit: 'µg/m³'),
Pollutant(name: 'PM10', value: 15, unit: 'µg/m³'),
Pollutant(name: 'O₃', value: 32, unit: 'ppb'),
],
);
}
}
+224
View File
@@ -0,0 +1,224 @@
import 'dart:math' as math;
import 'package:flutter/material.dart';
/// A speedometer-style gauge widget for displaying percentage values.
///
/// Commonly used for system stats like CPU, Memory, Disk usage.
class GaugeWidget extends StatelessWidget {
const GaugeWidget({
super.key,
required this.value,
required this.label,
this.size = 120,
this.strokeWidth = 10,
this.color,
this.backgroundColor,
this.showPercentage = true,
this.icon,
});
/// The value to display (0.0 - 1.0).
final double value;
/// Label displayed below the gauge.
final String label;
/// Size of the gauge widget.
final double size;
/// Width of the gauge arc stroke.
final double strokeWidth;
/// Color of the filled arc. Uses primary color if not specified.
final Color? color;
/// Color of the background arc. Uses surfaceVariant if not specified.
final Color? backgroundColor;
/// Whether to show the percentage text in the center.
final bool showPercentage;
/// Optional icon to show above the percentage.
final IconData? icon;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final effectiveColor = color ?? colorScheme.primary;
final effectiveBackgroundColor =
backgroundColor ?? colorScheme.surfaceContainerHighest;
// Clamp value between 0 and 1
final clampedValue = value.clamp(0.0, 1.0);
// Height is smaller since we only draw half circle
final gaugeHeight = size * 0.6;
final iconSpace = icon != null ? size * 0.36 : 0.0;
return SizedBox(
width: size,
height: gaugeHeight + 32 + iconSpace, // Space for label + icon
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
SizedBox(
width: size,
height: gaugeHeight,
child: CustomPaint(
painter: _GaugePainter(
value: clampedValue,
color: effectiveColor,
backgroundColor: effectiveBackgroundColor,
strokeWidth: strokeWidth,
),
child: Align(
alignment: const Alignment(0, 0.6),
child: showPercentage
? Text(
'${(clampedValue * 100).round()}%',
style: Theme.of(context).textTheme.titleLarge?.copyWith(
fontWeight: FontWeight.bold,
fontSize: size * 0.2,
),
)
: const SizedBox.shrink(),
),
),
),
const SizedBox(height: 4),
Text(
label,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
textAlign: TextAlign.center,
maxLines: 1,
overflow: TextOverflow.ellipsis,
),
if (icon != null) ...[
const SizedBox(height: 8),
Icon(
icon,
size: size * 0.28,
color: effectiveColor,
),
],
],
),
);
}
}
class _GaugePainter extends CustomPainter {
_GaugePainter({
required this.value,
required this.color,
required this.backgroundColor,
required this.strokeWidth,
});
final double value;
final Color color;
final Color backgroundColor;
final double strokeWidth;
@override
void paint(Canvas canvas, Size size) {
// Center at bottom of widget for speedometer style
final center = Offset(size.width / 2, size.height);
final radius = (size.width - strokeWidth) / 2;
// Speedometer arc: starts from left (180°) and sweeps 180° to right
const startAngle = math.pi; // 180 degrees (left side)
const sweepAngle = math.pi; // 180 degrees sweep (semicircle)
// Background arc
final backgroundPaint = Paint()
..color = backgroundColor
..style = PaintingStyle.stroke
..strokeWidth = strokeWidth
..strokeCap = StrokeCap.round;
canvas.drawArc(
Rect.fromCircle(center: center, radius: radius),
startAngle,
sweepAngle,
false,
backgroundPaint,
);
// Value arc
if (value > 0) {
final valuePaint = Paint()
..color = color
..style = PaintingStyle.stroke
..strokeWidth = strokeWidth
..strokeCap = StrokeCap.round;
canvas.drawArc(
Rect.fromCircle(center: center, radius: radius),
startAngle,
sweepAngle * value,
false,
valuePaint,
);
}
}
@override
bool shouldRepaint(_GaugePainter oldDelegate) {
return oldDelegate.value != value ||
oldDelegate.color != color ||
oldDelegate.backgroundColor != backgroundColor ||
oldDelegate.strokeWidth != strokeWidth;
}
}
/// A row of gauge widgets with consistent sizing.
class GaugeRow extends StatelessWidget {
const GaugeRow({
super.key,
required this.gauges,
this.gaugeSize = 100,
});
final List<GaugeData> gauges;
final double gaugeSize;
@override
Widget build(BuildContext context) {
return Wrap(
spacing: 24,
runSpacing: 16,
alignment: WrapAlignment.center,
children: gauges
.map(
(data) => GaugeWidget(
value: data.value,
label: data.label,
size: gaugeSize,
strokeWidth: gaugeSize * 0.1,
color: data.color,
icon: data.icon,
),
)
.toList(),
);
}
}
/// Data class for gauge configuration.
class GaugeData {
const GaugeData({
required this.value,
required this.label,
this.color,
this.icon,
});
final double value;
final String label;
final Color? color;
final IconData? icon;
}
+465
View File
@@ -0,0 +1,465 @@
import 'package:flutter/material.dart';
/// A widget that displays a grid of Material icons for selection.
///
/// Shows a button that opens a dialog with available icons.
class IconPicker extends StatelessWidget {
const IconPicker({
super.key,
required this.selectedIcon,
required this.onChanged,
this.label = 'Icon',
});
/// Currently selected icon name.
final String selectedIcon;
/// Callback when an icon is selected.
final ValueChanged<String> onChanged;
/// Label for the field.
final String label;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
label,
style: textTheme.labelMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
const SizedBox(height: 8),
InkWell(
onTap: () => _showIconPicker(context),
borderRadius: BorderRadius.circular(8),
child: Container(
padding: const EdgeInsets.all(12),
decoration: BoxDecoration(
border: Border.all(color: colorScheme.outline),
borderRadius: BorderRadius.circular(8),
),
child: Row(
children: [
Container(
width: 40,
height: 40,
decoration: BoxDecoration(
color: colorScheme.primaryContainer,
borderRadius: BorderRadius.circular(8),
),
child: Icon(
getIconData(selectedIcon),
color: colorScheme.onPrimaryContainer,
),
),
const SizedBox(width: 12),
Expanded(
child: Text(
selectedIcon,
style: textTheme.bodyLarge,
),
),
Icon(
Icons.arrow_drop_down,
color: colorScheme.onSurfaceVariant,
),
],
),
),
),
],
);
}
Future<void> _showIconPicker(BuildContext context) async {
final result = await showDialog<String>(
context: context,
builder: (context) => IconPickerDialog(
selectedIcon: selectedIcon,
onSelected: (icon) => Navigator.of(context).pop(icon),
),
);
if (result != null) {
onChanged(result);
}
}
}
/// Dialog that displays a grid of icons.
class IconPickerDialog extends StatefulWidget {
const IconPickerDialog({
super.key,
required this.selectedIcon,
required this.onSelected,
});
final String selectedIcon;
final ValueChanged<String> onSelected;
@override
State<IconPickerDialog> createState() => _IconPickerDialogState();
}
class _IconPickerDialogState extends State<IconPickerDialog> {
String _searchQuery = '';
List<String> get _filteredIcons {
if (_searchQuery.isEmpty) {
return availableIcons;
}
return availableIcons
.where((icon) => icon.toLowerCase().contains(_searchQuery.toLowerCase()))
.toList();
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Dialog(
child: Container(
width: 400,
height: 500,
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'Select Icon',
style: Theme.of(context).textTheme.titleLarge,
),
const SizedBox(height: 16),
TextField(
decoration: const InputDecoration(
hintText: 'Search icons...',
prefixIcon: Icon(Icons.search),
border: OutlineInputBorder(),
isDense: true,
),
onChanged: (value) => setState(() => _searchQuery = value),
),
const SizedBox(height: 16),
Expanded(
child: GridView.builder(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 5,
mainAxisSpacing: 8,
crossAxisSpacing: 8,
),
itemCount: _filteredIcons.length,
itemBuilder: (context, index) {
final iconName = _filteredIcons[index];
final isSelected = iconName == widget.selectedIcon;
return InkWell(
onTap: () => widget.onSelected(iconName),
borderRadius: BorderRadius.circular(8),
child: Container(
decoration: BoxDecoration(
color: isSelected
? colorScheme.primaryContainer
: colorScheme.surfaceContainerHighest,
borderRadius: BorderRadius.circular(8),
border: isSelected
? Border.all(color: colorScheme.primary, width: 2)
: null,
),
child: Tooltip(
message: iconName,
child: Icon(
getIconData(iconName),
color: isSelected
? colorScheme.onPrimaryContainer
: colorScheme.onSurface,
),
),
),
);
},
),
),
const SizedBox(height: 16),
Row(
mainAxisAlignment: MainAxisAlignment.end,
children: [
TextButton(
onPressed: () => Navigator.of(context).pop(),
child: const Text('Cancel'),
),
],
),
],
),
),
);
}
}
/// Common icons available for selection.
const List<String> availableIcons = [
'home',
'settings',
'search',
'menu',
'add',
'remove',
'close',
'check',
'edit',
'delete',
'favorite',
'star',
'movie',
'music_note',
'photo',
'videocam',
'camera',
'mic',
'volume_up',
'play_arrow',
'pause',
'stop',
'skip_next',
'skip_previous',
'folder',
'file_copy',
'cloud',
'cloud_download',
'cloud_upload',
'download',
'upload',
'share',
'link',
'public',
'language',
'dns',
'storage',
'memory',
'code',
'terminal',
'bug_report',
'api',
'http',
'vpn_key',
'lock',
'lock_open',
'security',
'verified_user',
'admin_panel_settings',
'monitor',
'monitoring',
'analytics',
'dashboard',
'speed',
'timer',
'schedule',
'calendar_today',
'event',
'notifications',
'email',
'message',
'chat',
'forum',
'person',
'people',
'group',
'account_circle',
'shopping_cart',
'credit_card',
'attach_money',
'trending_up',
'trending_down',
'wifi',
'bluetooth',
'router',
'devices',
'computer',
'laptop',
'phone_android',
'tablet',
'watch',
'tv',
'games',
'videogame_asset',
'sports_esports',
'local_cafe',
'local_dining',
'restaurant',
'directions_car',
'flight',
'hotel',
'map',
'place',
'explore',
'navigation',
'book',
'school',
'science',
'psychology',
'work',
'business',
'apartment',
'location_city',
'eco',
'water_drop',
'air',
'thermostat',
'bolt',
'light_mode',
'dark_mode',
'brightness_4',
'palette',
'brush',
'format_paint',
'extension',
'widgets',
'view_module',
'grid_view',
'list',
'table_chart',
'pie_chart',
'bar_chart',
'show_chart',
'donut_large',
'disc_full',
];
/// Convert icon name string to IconData.
IconData getIconData(String iconName) {
const iconMap = <String, IconData>{
'home': Icons.home,
'settings': Icons.settings,
'search': Icons.search,
'menu': Icons.menu,
'add': Icons.add,
'remove': Icons.remove,
'close': Icons.close,
'check': Icons.check,
'edit': Icons.edit,
'delete': Icons.delete,
'favorite': Icons.favorite,
'star': Icons.star,
'movie': Icons.movie,
'music_note': Icons.music_note,
'photo': Icons.photo,
'videocam': Icons.videocam,
'camera': Icons.camera,
'mic': Icons.mic,
'volume_up': Icons.volume_up,
'play_arrow': Icons.play_arrow,
'pause': Icons.pause,
'stop': Icons.stop,
'skip_next': Icons.skip_next,
'skip_previous': Icons.skip_previous,
'folder': Icons.folder,
'file_copy': Icons.file_copy,
'cloud': Icons.cloud,
'cloud_download': Icons.cloud_download,
'cloud_upload': Icons.cloud_upload,
'download': Icons.download,
'upload': Icons.upload,
'share': Icons.share,
'link': Icons.link,
'public': Icons.public,
'language': Icons.language,
'dns': Icons.dns,
'storage': Icons.storage,
'memory': Icons.memory,
'code': Icons.code,
'terminal': Icons.terminal,
'bug_report': Icons.bug_report,
'api': Icons.api,
'http': Icons.http,
'vpn_key': Icons.vpn_key,
'lock': Icons.lock,
'lock_open': Icons.lock_open,
'security': Icons.security,
'verified_user': Icons.verified_user,
'admin_panel_settings': Icons.admin_panel_settings,
'monitor': Icons.monitor,
'monitoring': Icons.monitor_heart,
'analytics': Icons.analytics,
'dashboard': Icons.dashboard,
'speed': Icons.speed,
'timer': Icons.timer,
'schedule': Icons.schedule,
'calendar_today': Icons.calendar_today,
'event': Icons.event,
'notifications': Icons.notifications,
'email': Icons.email,
'message': Icons.message,
'chat': Icons.chat,
'forum': Icons.forum,
'person': Icons.person,
'people': Icons.people,
'group': Icons.group,
'account_circle': Icons.account_circle,
'shopping_cart': Icons.shopping_cart,
'credit_card': Icons.credit_card,
'attach_money': Icons.attach_money,
'trending_up': Icons.trending_up,
'trending_down': Icons.trending_down,
'wifi': Icons.wifi,
'bluetooth': Icons.bluetooth,
'router': Icons.router,
'devices': Icons.devices,
'computer': Icons.computer,
'laptop': Icons.laptop,
'phone_android': Icons.phone_android,
'tablet': Icons.tablet,
'watch': Icons.watch,
'tv': Icons.tv,
'games': Icons.games,
'videogame_asset': Icons.videogame_asset,
'sports_esports': Icons.sports_esports,
'local_cafe': Icons.local_cafe,
'local_dining': Icons.local_dining,
'restaurant': Icons.restaurant,
'directions_car': Icons.directions_car,
'flight': Icons.flight,
'hotel': Icons.hotel,
'map': Icons.map,
'place': Icons.place,
'explore': Icons.explore,
'navigation': Icons.navigation,
'book': Icons.book,
'school': Icons.school,
'science': Icons.science,
'psychology': Icons.psychology,
'work': Icons.work,
'business': Icons.business,
'apartment': Icons.apartment,
'location_city': Icons.location_city,
'eco': Icons.eco,
'water_drop': Icons.water_drop,
'air': Icons.air,
'thermostat': Icons.thermostat,
'bolt': Icons.bolt,
'light_mode': Icons.light_mode,
'dark_mode': Icons.dark_mode,
'brightness_4': Icons.brightness_4,
'palette': Icons.palette,
'brush': Icons.brush,
'format_paint': Icons.format_paint,
'extension': Icons.extension,
'widgets': Icons.widgets,
'view_module': Icons.view_module,
'grid_view': Icons.grid_view,
'list': Icons.list,
'table_chart': Icons.table_chart,
'pie_chart': Icons.pie_chart,
'bar_chart': Icons.bar_chart,
'show_chart': Icons.show_chart,
'donut_large': Icons.donut_large,
'disc_full': Icons.disc_full,
};
return iconMap[iconName] ?? Icons.help_outline;
}
+257
View File
@@ -0,0 +1,257 @@
import 'package:flutter/material.dart';
/// Weather widget displaying current conditions.
///
/// Currently uses mock data. Will be connected to weather API in future.
class WeatherWidget extends StatelessWidget {
const WeatherWidget({
super.key,
this.data,
this.compact = false,
});
/// Weather data to display. Uses mock data if null.
final WeatherData? data;
/// Whether to use compact layout.
final bool compact;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final weather = data ?? WeatherData.mock();
if (compact) {
return _buildCompact(context, colorScheme, weather);
}
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
Icons.wb_sunny_outlined,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Expanded(
child: Text(
weather.location,
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
maxLines: 1,
overflow: TextOverflow.ellipsis,
),
),
],
),
const SizedBox(height: 16),
// Main weather display (matching AQI layout)
Row(
children: [
// Weather icon in box (like AQI number box)
Container(
width: 64,
height: 64,
decoration: BoxDecoration(
color: (weather.iconColor ?? colorScheme.primary)
.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(12),
border: Border.all(
color: (weather.iconColor ?? colorScheme.primary)
.withValues(alpha: 0.3),
width: 2,
),
),
child: Center(
child: Icon(
weather.icon,
size: 32,
color: weather.iconColor ?? colorScheme.primary,
),
),
),
const SizedBox(width: 16),
// Temperature and condition
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'${weather.temperature.round()}°${weather.unit.symbol}',
style:
Theme.of(context).textTheme.titleMedium?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 4),
Text(
weather.condition,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
maxLines: 2,
overflow: TextOverflow.ellipsis,
),
],
),
),
],
),
// Details
if (weather.humidity != null || weather.windSpeed != null) ...[
const SizedBox(height: 16),
const Divider(height: 1),
const SizedBox(height: 12),
Wrap(
spacing: 16,
runSpacing: 8,
children: [
if (weather.humidity != null)
_DetailChip(
label: 'Humidity',
value: '${weather.humidity}%',
),
if (weather.windSpeed != null)
_DetailChip(
label: 'Wind',
value: '${weather.windSpeed!.round()} ${weather.windUnit}',
),
if (weather.feelsLike != null)
_DetailChip(
label: 'Feels',
value: '${weather.feelsLike!.round()}°${weather.unit.symbol}',
),
],
),
],
],
),
),
);
}
Widget _buildCompact(
BuildContext context,
ColorScheme colorScheme,
WeatherData weather,
) {
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
weather.icon,
size: 24,
color: weather.iconColor ?? colorScheme.primary,
),
const SizedBox(width: 8),
Text(
'${weather.temperature.round()}°${weather.unit.symbol}',
style: Theme.of(context).textTheme.titleMedium?.copyWith(
fontWeight: FontWeight.bold,
),
),
],
),
),
);
}
}
class _DetailChip extends StatelessWidget {
const _DetailChip({
required this.label,
required this.value,
});
final String label;
final String value;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Row(
mainAxisSize: MainAxisSize.min,
children: [
Text(
label,
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: colorScheme.outline,
),
),
const SizedBox(width: 4),
Text(
value,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
fontWeight: FontWeight.w500,
),
),
],
);
}
}
/// Temperature unit for weather display.
enum TemperatureUnit {
celsius('C'),
fahrenheit('F');
const TemperatureUnit(this.symbol);
final String symbol;
}
/// Weather data model.
class WeatherData {
const WeatherData({
required this.location,
required this.temperature,
required this.condition,
required this.icon,
this.unit = TemperatureUnit.celsius,
this.humidity,
this.windSpeed,
this.windUnit = 'km/h',
this.feelsLike,
this.iconColor,
});
final String location;
final double temperature;
final String condition;
final IconData icon;
final TemperatureUnit unit;
final int? humidity;
final double? windSpeed;
final String windUnit;
final double? feelsLike;
final Color? iconColor;
/// Mock weather data for development.
factory WeatherData.mock() {
return const WeatherData(
location: 'Rotterdam, NL',
temperature: 8,
condition: 'Partly Cloudy',
icon: Icons.cloud,
humidity: 72,
windSpeed: 18,
feelsLike: 5,
iconColor: Colors.blueGrey,
);
}
}
+7
View File
@@ -0,0 +1,7 @@
/// Shared widgets for Tatlock UI.
library;
export 'air_quality_widget.dart';
export 'gauge_widget.dart';
export 'icon_picker.dart';
export 'weather_widget.dart';
+2 -2
View File
@@ -7,7 +7,7 @@ class AppVersion {
static const String name = 'tatlock_ui';
static const String description = 'Tatlock - a Home Lab AI';
static const String version = '0.3.0';
static const String version = '0.3.3';
static const int buildNumber = 1;
static const String fullVersion = '0.3.0+1';
static const String fullVersion = '0.3.3+1';
}
+1 -1
View File
@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 0.3.1+1
version: 0.3.3+1
environment:
sdk: ^3.10.4
BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 917 B

After

Width:  |  Height:  |  Size: 2.6 KiB

+7
View File
@@ -0,0 +1,7 @@
<!DOCTYPE html>
<html>
<head>
<title>OK</title>
</head>
<body>OK</body>
</html>
Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.2 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.1 KiB

After

Width:  |  Height:  |  Size: 102 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.5 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 102 KiB

+3 -3
View File
@@ -18,18 +18,18 @@
<meta charset="UTF-8">
<meta content="IE=Edge" http-equiv="X-UA-Compatible">
<meta name="description" content="A new Flutter project.">
<meta name="description" content="Tatlock Home Dashboard">
<!-- iOS meta tags & icons -->
<meta name="mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<meta name="apple-mobile-web-app-title" content="tatlock_ui">
<meta name="apple-mobile-web-app-title" content="Tatlock">
<link rel="apple-touch-icon" href="icons/Icon-192.png">
<!-- Favicon -->
<link rel="icon" type="image/png" href="favicon.png"/>
<title>tatlock_ui</title>
<title>Tatlock</title>
<link rel="manifest" href="manifest.json">
</head>
<body>
+5 -5
View File
@@ -1,11 +1,11 @@
{
"name": "tatlock_ui",
"short_name": "tatlock_ui",
"name": "Tatlock",
"short_name": "Tatlock",
"start_url": ".",
"display": "standalone",
"background_color": "#0175C2",
"theme_color": "#0175C2",
"description": "A new Flutter project.",
"background_color": "#1a1a2e",
"theme_color": "#1a1a2e",
"description": "Tatlock Home Dashboard",
"orientation": "portrait-primary",
"prefer_related_applications": false,
"icons": [