# Installation

Build and run the Nostr Mail client on your platform.

# Prerequisites

Flutter SDK 3.10.4+
Dart SDK 3.10.4+

Verify your installation:

flutter doctor

# Clone & Setup

# Clone the repository
git clone https://github.com/nogringo/nostr-mail-client
cd nostr-mail-client

# Install dependencies
flutter pub get

# Run the App

# Development

# Default platform
flutter run

# Specific platform
flutter run -d chrome       # Web
flutter run -d macos        # macOS
flutter run -d windows      # Windows
flutter run -d linux        # Linux

# Release Build

flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk

flutter build ios --release
# Then archive with Xcode

flutter build web --release
# Output: build/web/

flutter build macos --release
# Output: build/macos/Build/Products/Release/

flutter build windows --release
# Output: build/windows/runner/Release/

flutter build linux --release
# Output: build/linux/x64/release/bundle/

# Platform-Specific Setup

# Android

No additional setup required.

# iOS

Open ios/Runner.xcworkspace in Xcode
Set your development team
Configure signing

# Web

Add to web/index.html if needed for CORS:

<script>
  // CORS proxy configuration if needed
</script>

# Desktop (macOS/Windows/Linux)

Enable desktop support:

flutter config --enable-macos-desktop
flutter config --enable-windows-desktop
flutter config --enable-linux-desktop

# Configuration

# Relays

The default relays are configured in the app. To customize:

Open lib/services/ndk_service.dart
Modify the bootstrapRelays list

final ndk = Ndk(NdkConfig(
  bootstrapRelays: [
    'wss://relay.damus.io',
    'wss://nos.lol',
    // Add your relays here
  ],
));

# Troubleshooting

# Dependency Issues

flutter clean
flutter pub get

# Build Errors

# Update Flutter
flutter upgrade

# Regenerate platform files
flutter create --platforms=android,ios,web .

# Rust Issues (NDK)

The NDK uses Rust for signature verification. If you encounter issues:

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Add targets
rustup target add aarch64-linux-android
rustup target add armv7-linux-androideabi
rustup target add x86_64-linux-android
rustup target add i686-linux-android