Welcome to the comprehensive documentation for SoluiNet.DevTools.Console, a cross-platform developer tools application built on .NET 8.0.

SoluiNet.DevTools.Console is a powerful, extensible command-line application that provides developers with a unified set of tools across Windows, Linux, and macOS platforms. Built with modern .NET 8.0 and designed for cross-platform compatibility, it offers a plugin-based architecture that allows for easy extension and customization.

• Cross-Platform Compatibility: Runs natively on Windows, Linux, and macOS
• Multi-Architecture Support: Supports both x64 and ARM64 architectures
• Plugin System: Extensible architecture with dynamic plugin loading
• Modern .NET 8.0: Built on the latest .NET platform for optimal performance
• Command-Line Interface: Powerful CLI with comprehensive help and diagnostics
• Configuration Management: Flexible, platform-aware configuration system
• Comprehensive Logging: Advanced logging with platform-specific integrations

Choose your preferred installation method:

Windows (Chocolatey):

choco install soluinet-devtools-console

Linux (APT):

sudo apt install soluinet-devtools-console

macOS (Homebrew):

brew install soluinet/devtools/soluinet-devtools-console

Manual Installation: Download the appropriate package for your platform from the releases page.

# Check version and system information
sndt --version

# Display help
sndt --help

# List available plugins
sndt plugin list

# Run diagnostics
sndt diagnostics

• Installation Guide - Platform-specific installation instructions
• Configuration Guide - Configure the application for your needs
• Quick Start Tutorial - Get up and running in minutes

• Build Guide - Build from source using dotnet CLI
• Plugin Development Guide - Create custom plugins
• API Reference - Programming interfaces and APIs

• Deployment Guide - Deploy across different environments
• Troubleshooting Guide - Resolve common issues
• Performance Tuning - Optimize for your use case

• Security Guide - Security best practices and configuration
• Integration Guide - Integrate with other tools and systems
• Migration Guide - Migrate from previous versions

graph TB
    A[Console Application] --> B[Platform Abstraction Layer]
    A --> C[Configuration System]
    A --> D[Plugin System]
    A --> E[Logging System]
    
    B --> F[Windows Platform Service]
    B --> G[Linux Platform Service]
    B --> H[macOS Platform Service]
    
    C --> I[Cross-Platform Config Manager]
    C --> J[Configuration Migration]
    
    D --> K[Plugin Discovery]
    D --> L[Assembly Resolver]
    D --> M[Plugin Loader]
    
    E --> N[NLog Integration]
    E --> O[Platform-Specific Logging]

1. Platform Abstraction Layer: Handles platform-specific operations and file system conventions
2. Configuration System: Manages application and plugin settings with platform-aware paths
3. Plugin System: Discovers, loads, and manages plugins with cross-platform compatibility
4. Logging System: Provides comprehensive logging with platform-specific integrations
5. Command-Line Interface: Offers rich CLI experience with help, diagnostics, and interactive features

• Windows Service integration
• Registry configuration support
• Windows Event Log integration
• PowerShell script integration
• MSI installer support

• Systemd service integration
• Syslog integration
• Package manager support (APT, YUM, DNF)
• Container deployment (Docker, Podman)
• Snap and Flatpak packaging

• Launch daemon integration
• macOS unified logging (os_log)
• Homebrew and MacPorts support
• App bundle packaging
• Code signing and notarization

The application stores configuration in platform-appropriate locations:

• Windows: %APPDATA%\SoluiNet\DevTools\
• Linux: ~/.config/soluinet-devtools/
• macOS: ~/Library/Application Support/SoluiNet.DevTools/

Create custom plugins using the plugin SDK:

public class MyPlugin : IBasePlugin
{
    public string Name => "My Custom Plugin";
    public string Description => "Custom functionality";
    
    public void Initialize()
    {
        // Plugin initialization
    }
    
    public void Execute(string[] args)
    {
        // Plugin logic
    }
}

See the Plugin Development Guide for detailed instructions.

# Application information
sndt --version              # Show version information
sndt --help                 # Display help
sndt info --system          # System information
sndt diagnostics            # Run diagnostics

# Configuration management
sndt config show            # Show current configuration
sndt config set key value   # Set configuration value
sndt config reset           # Reset to defaults

# Plugin management
sndt plugin list            # List available plugins
sndt plugin enable name     # Enable plugin
sndt plugin disable name    # Disable plugin
sndt plugin install file    # Install plugin from file

# Performance and monitoring
sndt diagnostics --performance    # Performance diagnostics
sndt health --monitor            # Health monitoring
sndt maintenance --optimize      # Optimize performance

# Development and debugging
sndt --log-level Debug          # Enable debug logging
sndt plugin validate --all      # Validate all plugins
sndt config validate            # Validate configuration

Configure the application using environment variables:

• .NET 8.0 SDK
• Git

# Clone repository
git clone https://github.com/SoluiNet/SoluiNet.DevTools.git
cd SoluiNet.DevTools

# Restore dependencies
dotnet restore

# Build for current platform
dotnet build SoluiNet.DevTools.Console/SoluiNet.DevTools.Console.csproj --configuration Release

# Build for specific platform
dotnet publish SoluiNet.DevTools.Console/SoluiNet.DevTools.Console.csproj \
  --configuration Release \
  --runtime linux-x64 \
  --output ./build/linux-x64

# Build all platforms
./scripts/build-all-platforms.sh --configuration Release

See the Build Guide for comprehensive build instructions.

# Run all tests
dotnet test SoluiNet.DevTools.UnitTest/SoluiNet.DevTools.UnitTest.csproj

# Run with coverage
dotnet test --collect:"XPlat Code Coverage"

# Cross-platform testing
./scripts/test-all-platforms.sh

• Unit Tests: Core functionality testing
• Integration Tests: Plugin and system integration
• Cross-Platform Tests: Platform-specific behavior validation
• Performance Tests: Performance and resource usage validation

We welcome contributions! Please see our Contributing Guide for details on:

• Code style and standards
• Pull request process
• Issue reporting
• Development setup
• Testing requirements

1. Fork the repository
2. Clone your fork
3. Install .NET 8.0 SDK
4. Run dotnet restore
5. Make your changes
6. Run tests: dotnet test
7. Submit a pull request

• Documentation: https://docs.soluinet.com/devtools
• GitHub Issues: Report bugs and request features
• GitHub Discussions: Community discussions
• Email Support: support@soluinet.com

• Wiki: Community-maintained documentation
• Examples: Sample plugins and configurations
• Blog: Development updates and tutorials

• ✅ Cross-platform .NET 8.0 support
• ✅ Multi-architecture builds (x64, ARM64)
• ✅ Plugin system with cross-platform compatibility
• ✅ Comprehensive configuration system
• ✅ Advanced logging and diagnostics

• 🔄 Native AOT compilation support
• 🔄 Container-first deployment options
• 🔄 Enhanced plugin security and sandboxing
• 🔄 Built-in update mechanism
• 🔄 Performance monitoring and metrics

• 📋 Web-based management interface
• 📋 Distributed plugin repository
• 📋 Cloud-native integrations
• 📋 AI-powered development assistance
• 📋 Enhanced security features

This project is licensed under the MIT License. See the LICENSE file for details.

• Built with .NET 8.0
• Logging powered by NLog
• Cross-platform compatibility enabled by .NET Runtime
• Community contributions and feedback

Last Updated: October 27, 2025
Version: 1.0.0
Supported Platforms: Windows 10/11, Linux (Ubuntu 18.04+, RHEL 7+), macOS 10.15+
Architectures: x64, ARM64