Skip to content

Feat: Share and Save logs files #412

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
grunch merged 34 commits into from
Jan 24, 2026
Merged

Feat: Share and Save logs files #412

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
3e5fc21
feat: add logger service with memory buffer and Riverpod provider
BraCR10 Jan 7, 2026
96bf7b1
fix : update config with logger constants
BraCR10 Jan 7, 2026
f31cdb6
feat : connect logs screen to logger service with real-time display
BraCR10 Jan 7, 2026
6b59aee
feat: sync logging toggle with MemoryLogOutput
BraCR10 Jan 7, 2026
062eef6
refactor: migrate files to use logger singleton
BraCR10 Jan 7, 2026
f5ed78b
docs: updating docs
BraCR10 Jan 7, 2026
e75a6d3
Merge branch 'feat/logging-phase-1' into feat/logging-phase-2
BraCR10 Jan 7, 2026
ae88c0c
Merge branch 'feat/logging-phase-1' into feat/logging-phase-2
BraCR10 Jan 7, 2026
c204c95
Merge remote-tracking branch 'origin/main' into feat/logging-phase-2
BraCR10 Jan 9, 2026
d040ffe
Migrate NostrService to use logger singleton
BraCR10 Jan 12, 2026
64fc240
Migrate mostro_storage to use logger singleton
BraCR10 Jan 12, 2026
c16c74a
Update docs for Phase 3 completion
BraCR10 Jan 12, 2026
5b7dd99
Enable isolate log receiver for background services
BraCR10 Jan 12, 2026
389b4be
Update docs for Phase 4 completion
BraCR10 Jan 12, 2026
cfd4fe7
Add bottom padding to logs list to prevent overlap with system buttons
BraCR10 Jan 13, 2026
80c6415
Localize relative time strings using timeAgoWithLocale extension
BraCR10 Jan 13, 2026
04c4482
Increase bottom padding in logs list to prevent overlap with system n…
BraCR10 Jan 13, 2026
6b8f801
Merge branch 'feat/logging-phase-2' into feat/logging-phases-3&4
BraCR10 Jan 13, 2026
d36ff88
Merge branch 'main' into feat/logging-phases-3&4
BraCR10 Jan 13, 2026
8382b55
Fix typo in LOGGING_IMPLEMENTATION.md
BraCR10 Jan 13, 2026
2e03a1e
Configure logger with IsolateLogOutput in mobile background isolate
BraCR10 Jan 13, 2026
8e2e557
Print background isolate logs to console only in debug mode
BraCR10 Jan 13, 2026
3ea02f5
Merge remote-tracking branch 'origin/feat/logging-phases-3&4' into fe…
BraCR10 Jan 13, 2026
30546b7
Add fallback logging for errors before logger initialization
BraCR10 Jan 15, 2026
cce5541
Add logger export service for logs save and share
BraCR10 Jan 17, 2026
13fd6b2
Add hamburger menu widget for logs screen
BraCR10 Jan 17, 2026
5331c4b
Integrate hamburger menu into logs screen
BraCR10 Jan 17, 2026
5ae1fdf
Remove unused logExportPath from Settings model
BraCR10 Jan 17, 2026
2e1cc9a
Add translations for logs export functionality
BraCR10 Jan 17, 2026
eab5ec3
Update documentation for Phase 5 completion
BraCR10 Jan 17, 2026
d3e6376
Merge remote-tracking branch 'origin/main' into feat/logging-phase-5
BraCR10 Jan 20, 2026
7c70560
Fix: code rabbit suggestions
BraCR10 Jan 20, 2026
282304a
Merge branch 'main' into feat/logging-phase-5
BraCR10 Jan 21, 2026
5e9b508
Merge branch 'main' into feat/logging-phase-5
BraCR10 Jan 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions docs/LOGGING_IMPLEMENTATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,12 @@ Implementation of a comprehensive logging system for MostroP2P mobile app with i
- Desktop background service with isolate logging
- Isolate log receiver initialized in main.dart

### Phase 5: File Export & Persistence
- Auto-save to storage
- Restore on app restart
- Generate .txt files
### Phase 5: File Export & Persistence (Completed)
- Manual export via hamburger menu
- Save logs to user-selected location using FilePicker
- Share logs via native system share sheet
- Folder picker and permissions
- Clear logs with confirmation dialog

### Phase 6: UI Enhancements
- Recording indicator widget
Expand Down Expand Up @@ -206,6 +207,6 @@ void backgroundMain(SendPort sendPort) async {

---

**Version**: 5
**Status**: Phase 4 - Completed
**Version**: 6
**Status**: Phase 5 - Completed
**Last Updated**: 2026-01-12
57 changes: 8 additions & 49 deletions lib/features/logs/screens/logs_screen.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ import 'package:logger/logger.dart';
import 'package:mostro_mobile/core/app_theme.dart';
import 'package:mostro_mobile/core/config.dart';
import 'package:mostro_mobile/features/logs/logs_provider.dart';
import 'package:mostro_mobile/features/logs/widgets/logs_actions_menu.dart';
import 'package:mostro_mobile/features/settings/settings_provider.dart';
import 'package:mostro_mobile/generated/l10n.dart';
import 'package:mostro_mobile/services/logger_service.dart';
import 'package:mostro_mobile/shared/utils/datetime_extensions_utils.dart';
import 'package:mostro_mobile/shared/utils/snack_bar_helper.dart';

class LogsScreen extends ConsumerStatefulWidget {
const LogsScreen({super.key});
Expand All @@ -17,7 +17,7 @@ class LogsScreen extends ConsumerStatefulWidget {
ConsumerState<LogsScreen> createState() => _LogsScreenState();
}

class _LogsScreenState extends ConsumerState<LogsScreen> {
class _LogsScreenState extends ConsumerState<LogsScreen> with WidgetsBindingObserver {
String? _selectedLevel;
String _searchQuery = '';
final TextEditingController _searchController = TextEditingController();
Expand All @@ -28,6 +28,7 @@ class _LogsScreenState extends ConsumerState<LogsScreen> {
void initState() {
super.initState();
_scrollController.addListener(_onScroll);
WidgetsBinding.instance.addObserver(this);
}

void _onScroll() {
Expand All @@ -50,11 +51,15 @@ class _LogsScreenState extends ConsumerState<LogsScreen> {

@override
void dispose() {
WidgetsBinding.instance.removeObserver(this);
_scrollController.dispose();
_searchController.dispose();
super.dispose();
}

@override
void didChangeAppLifecycleState(AppLifecycleState state) {}

Future<void> _toggleLogging(bool value) async {
if (value) {
await _showPerformanceWarning();
Expand Down Expand Up @@ -110,48 +115,6 @@ class _LogsScreenState extends ConsumerState<LogsScreen> {
}
}

Future<void> _showClearConfirmation() async {
final confirmed = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
backgroundColor: AppTheme.backgroundCard,
title: Text(
S.of(context)!.clearLogs,
style: TextStyle(color: AppTheme.textPrimary),
),
content: Text(
S.of(context)!.clearLogsConfirmation,
style: TextStyle(color: AppTheme.textSecondary),
),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(false),
child: Text(S.of(context)!.cancel),
),
ElevatedButton(
onPressed: () => Navigator.of(context).pop(true),
style: ElevatedButton.styleFrom(
backgroundColor: AppTheme.statusError,
),
child: Text(S.of(context)!.clear),
),
],
),
);

if (confirmed == true && mounted) {
ref.read(logsProvider.notifier).clearLogs();
WidgetsBinding.instance.addPostFrameCallback((_) {
if (mounted) {
SnackBarHelper.showTopSnackBar(
context,
S.of(context)!.logsCleared,
);
}
});
}
}

@override
Widget build(BuildContext context) {
final settings = ref.watch(settingsProvider);
Expand Down Expand Up @@ -180,11 +143,7 @@ class _LogsScreenState extends ConsumerState<LogsScreen> {
),
iconTheme: const IconThemeData(color: AppTheme.textPrimary),
actions: [
IconButton(
icon: const Icon(Icons.delete_outline),
onPressed: logs.isEmpty ? null : _showClearConfirmation,
tooltip: S.of(context)!.clearLogs,
),
LogsActionsMenu(),
],
),
body: SafeArea(
Expand Down
207 changes: 207 additions & 0 deletions lib/features/logs/widgets/logs_actions_menu.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,207 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:heroicons/heroicons.dart';
import 'package:logger/logger.dart';
import 'package:mostro_mobile/core/app_theme.dart';
import 'package:mostro_mobile/features/logs/logs_provider.dart';
import 'package:mostro_mobile/generated/l10n.dart';
import 'package:mostro_mobile/services/logger_export_service.dart';
import 'package:mostro_mobile/services/logger_service.dart';

class LogsActionsMenu extends ConsumerWidget {
final _logger = Logger();

LogsActionsMenu({super.key});

@override
Widget build(BuildContext context, WidgetRef ref) {
final logs = ref.watch(logsProvider);
final hasLogs = logs.isNotEmpty;

return PopupMenuButton<String>(
icon: const HeroIcon(
HeroIcons.ellipsisVertical,
style: HeroIconStyle.outline,
color: AppTheme.cream1,
size: 24,
),
color: AppTheme.backgroundDark,
onSelected: (value) => _handleMenuAction(context, ref, value, logs),
itemBuilder: (context) => [
_buildMenuItem(
'save',
HeroIcons.arrowDownTray,
S.of(context)!.saveLogs,
hasLogs ? AppTheme.cream1 : AppTheme.textSecondary,
enabled: hasLogs,
),
_buildMenuItem(
'share',
HeroIcons.share,
S.of(context)!.shareLogs,
hasLogs ? AppTheme.cream1 : AppTheme.textSecondary,
enabled: hasLogs,
),
_buildMenuItem(
'clear',
HeroIcons.trash,
S.of(context)!.clearLogs,
hasLogs ? AppTheme.statusError : AppTheme.textSecondary,
enabled: hasLogs,
),
],
);
}

PopupMenuItem<String> _buildMenuItem(
String value,
HeroIcons icon,
String label,
Color color, {
bool enabled = true,
}) {
return PopupMenuItem(
value: value,
enabled: enabled,
child: Row(
children: [
HeroIcon(
icon,
style: HeroIconStyle.outline,
size: 20,
color: color,
),
const SizedBox(width: 12),
Text(
label,
style: TextStyle(
color: enabled ? AppTheme.textPrimary : AppTheme.textSecondary,
),
),
],
),
);
}

Future<void> _handleMenuAction(
BuildContext context,
WidgetRef ref,
String action,
List<LogEntry> logs,
) async {
switch (action) {
case 'save':
await _saveLogsToFolder(context, ref, logs);
break;
case 'share':
await _shareLogsFile(context, logs);
break;
case 'clear':
await _showClearConfirmation(context, ref);
break;
}
}

Future<void> _saveLogsToFolder(
BuildContext context,
WidgetRef ref,
List<LogEntry> logs,
) async {
final localizations = S.of(context)!;
final strings = LogExportStrings(
headerTitle: localizations.logsHeaderTitle,
generatedLabel: localizations.logsGeneratedLabel,
totalLabel: localizations.logsTotalLabel,
emptyMessage: localizations.noLogsAvailable,
);

try {
final filePath = await LoggerExportService.exportLogsToFolder(logs, strings);

if (filePath != null && context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text(localizations.logsExportSuccess),
backgroundColor: AppTheme.statusSuccess,
),
);
}
} catch (e, stackTrace) {
_logger.e('Error exporting logs', error: e, stackTrace: stackTrace);
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text(localizations.logsExportError),
backgroundColor: AppTheme.statusError,
),
);
}
}
}

Future<void> _shareLogsFile(BuildContext context, List<LogEntry> logs) async {
final localizations = S.of(context)!;
final strings = LogExportStrings(
headerTitle: localizations.logsHeaderTitle,
generatedLabel: localizations.logsGeneratedLabel,
totalLabel: localizations.logsTotalLabel,
emptyMessage: localizations.noLogsAvailable,
);

try {
final file = await LoggerExportService.exportLogsForSharing(logs, strings);
await LoggerExportService.shareLogs(
file,
subject: localizations.logsShareSubject,
text: localizations.logsShareText,
);
} catch (e, stackTrace) {
_logger.e('Error sharing logs', error: e, stackTrace: stackTrace);
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text(localizations.shareLogsError),
backgroundColor: AppTheme.statusError,
),
);
}
}
}

Future<void> _showClearConfirmation(BuildContext context, WidgetRef ref) async {
final confirmed = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
backgroundColor: AppTheme.backgroundDark,
title: Text(
S.of(context)!.clearLogs,
style: const TextStyle(color: AppTheme.textPrimary),
),
content: Text(
S.of(context)!.clearLogsConfirmation,
style: const TextStyle(color: AppTheme.textSecondary),
),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(false),
child: Text(
S.of(context)!.cancel,
style: const TextStyle(color: AppTheme.textSecondary),
),
),
TextButton(
onPressed: () => Navigator.of(context).pop(true),
child: Text(
S.of(context)!.clear,
style: const TextStyle(color: AppTheme.statusError),
),
),
],
),
);

if (confirmed == true) {
ref.read(logsProvider.notifier).clearLogs();
}
}
}
4 changes: 2 additions & 2 deletions lib/features/settings/settings.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ class Settings {
final String? defaultFiatCode;
final String? selectedLanguage; // null means use system locale
final String? defaultLightningAddress;
final List<String> blacklistedRelays; // Relays blocked by user from auto-sync
final List<Map<String, dynamic>> userRelays; // User-added relays with metadata
final List<String> blacklistedRelays;
final List<Map<String, dynamic>> userRelays;
final bool isLoggingEnabled;
// Push notification settings
final bool pushNotificationsEnabled;
Expand Down
10 changes: 10 additions & 0 deletions lib/l10n/intl_en.arb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1300,6 +1300,16 @@
"devTools": "Dev Tools",
"devToolsWarning": "For debugging and troubleshooting only",
"viewAndExportLogs": "View and export application logs",
"saveLogs": "Save Logs",
"logsExportSuccess": "Logs exported successfully",
"logsExportError": "Failed to export logs",
"shareLogsError": "Failed to share logs",
"exportSettings": "Export Settings",
"logsHeaderTitle": "Mostro P2P Application Logs",
"logsGeneratedLabel": "Generated",
"logsTotalLabel": "Total logs",
"logsShareSubject": "Mostro P2P Logs",
"logsShareText": "Application logs from Mostro P2P",
"pushNotifications": "Push Notifications",
"pushNotificationsDescription": "Receive notifications when there are updates to your trades, even when the app is closed.",
"pushNotificationsNotSupported": "Push notifications are not supported on this platform.",
Expand Down
10 changes: 10 additions & 0 deletions lib/l10n/intl_es.arb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1276,6 +1276,16 @@
"devTools": "Herramientas de Desarrollo",
"devToolsWarning": "Solo para depuración y solución de problemas",
"viewAndExportLogs": "Ver y exportar registros de la aplicación",
"saveLogs": "Guardar Registros",
"logsExportSuccess": "Registros exportados exitosamente",
"logsExportError": "Error al exportar registros",
"shareLogsError": "Error al compartir registros",
"exportSettings": "Configuración de Exportación",
"logsHeaderTitle": "Registros de Aplicación Mostro P2P",
"logsGeneratedLabel": "Generado",
"logsTotalLabel": "Total de registros",
"logsShareSubject": "Registros Mostro P2P",
"logsShareText": "Registros de aplicación de Mostro P2P",
"pushNotifications": "Notificaciones Push",
"pushNotificationsDescription": "Recibe notificaciones cuando haya actualizaciones en tus operaciones, incluso cuando la app está cerrada.",
"pushNotificationsNotSupported": "Las notificaciones push no están soportadas en esta plataforma.",
Expand Down
Loading