Project Documentation
Choose a project type that interests you to dive deep into different implementations of Verdure Assistant.
🚀 Project Overview
Verdure Assistant provides four different project implementations, each optimized for specific use cases and platforms.
Project Comparison
| Project Type | Platform Support | Difficulty | Use Cases | Learning Order |
|---|---|---|---|---|
| Console Application | Windows/Linux/macOS | ⭐⭐ | Core architecture, server deployment | 1️⃣ First choice |
| WinUI Desktop App | Windows 10+ | ⭐⭐⭐ | Windows desktop UI | 2️⃣ |
| API Service | Windows/Linux/macOS | ⭐⭐⭐⭐ | Raspberry Pi robots, IoT integration | 3️⃣ |
| MAUI Cross-platform | Android/iOS/Windows/macOS | ⭐⭐⭐⭐⭐ | Mobile app development | 4️⃣ |
📱 Project Details
Console Application
Best starting choice - Ideal entry point for understanding core project architecture
- ✅ Simple & Direct: Command-line interface focusing on core functionality
- ✅ Cross-platform: Runs on all major platforms
- ✅ Learning-friendly: Clear code structure, easy to understand
- ✅ Quick setup: Minimal dependencies and configuration
Suitable for:
- .NET beginners
- Developers wanting to understand project architecture
- DevOps engineers needing server deployment
Start learning Console project →
WinUI Desktop App
Modern Windows app development - Experience the latest Windows application interface
- 🖥️ Modern UI: Smooth interface based on WinUI 3
- 🎤 Visual interaction: Real-time voice waveform and status display
- ⚙️ Graphical configuration: No need to manually edit config files
- 🎨 Theme support: Automatic light/dark theme switching
Suitable for:
- Windows app developers
- UI/UX designers
- Desktop application users
Start learning WinUI project →
API Service
Server-side development - Build powerful backend services
- 🤖 IoT integration: Optimized for Raspberry Pi and embedded devices
- 📡 Real-time communication: WebSocket bidirectional communication
- 🌐 RESTful API: Standardized interface design
- 🔧 Device management: Complete device registration and monitoring
Suitable for:
- Backend developers
- IoT/Hardware engineers
- System architects
MAUI Cross-platform App
Mobile app development - One codebase, multiple platforms
- 📱 Truly cross-platform: Android, iOS, Windows, macOS
- 🎨 Native experience: Platform-specific UI controls
- 🔄 Offline support: Local data storage and synchronization
- 🔐 Secure & reliable: End-to-end encryption and permission management
Suitable for:
- Mobile app developers
- Cross-platform technology enthusiasts
- Developers wanting to master MAUI
🎯 Learning Recommendations
Beginner Path
- Start with Console: Understand core concepts and architecture
- Move to WinUI: Learn user interface development
- Explore API: Master server-side development
- Challenge MAUI: Experience cross-platform development
Experienced Developers
Choose directly based on your interests and needs:
- Desktop app developers → WinUI Project
- Backend/API developers → API Project
- Mobile app developers → MAUI Project
- System administrators → Console Project
Full-stack Learning
If you want to master the entire technology stack, we recommend learning in this order:
Console → API → WinUI → MAUI
↓ ↓ ↓ ↓
Core Server Desktop Mobile🛠️ Development Environment
All projects require the following basic environment:
- .NET 9.0 SDK or higher
- Visual Studio 2022 or Visual Studio Code
- Git version control
For additional requirements specific to each project, please refer to their detailed documentation.
📚 Related Resources
- Getting Started - 5-minute quick guide
- Environment Setup - Development environment configuration
- Tech Stack Introduction - Learn about technologies used
- Project Architecture - Understand system design
Choose a project to start your Verdure Assistant learning journey! Each project has detailed documentation, sample code, and practical guidance.