🐍 Aspid.MVVM is a high-performance MVVM framework for Unity, built on Source Generator, designed with a focus on simplicity, scalability, and clear separation of business logic from presentation.
The framework enables a clean architecture where the View, logic, and data are distinctly separated. This allows programmers and designers to work in parallel without interfering with each other, enabling teams to scale projects without descending into chaos.
[Documentation] [Source Code]
⚡️Key Features:
1. Data Binding
Aspid.MVVM supports four primary data binding modes between View and ViewModel:
- OneWay – Automatically updates the View when the ViewModel changes.
- TwoWay – Bidirectional synchronization between View and ViewModel.
- OneTime – Sets the value once during initialization.
- OneWayToSource – Updates the ViewModel when the View changes.
Binding modes can be easily specified:
- In the View: Directly via the Unity Inspector.
- In the ViewModel: Using attributes to restrict allowed binding modes.
Bindings operate without reflection or boxing/unboxing, ensuring high performance.
2. ViewModel
With the built-in Source Generator, you can bind any data type:
- No need to inherit from specialized base classes.
- No wrappers or wrapped properties required.
- No boilerplate code, using attributes for configuration.
3. Commands
A power command mechanism:
- Supports up to four parameters — simply select the desired signature.
- The [RelayCommand] attribute transforms a regular method into a command with CanExecute support.
4. Observable Collections
A set of flexible, covariant observable collections:
- ObservableList<T>
- ObservableDictionary<TKey, TValue>
- ObservableHasSet<T>
- ObservableStack<T>
- ObservableQueue<T>
Features:
- Easy synchronization between two dependent collections.
- Support for filtering and sorting without modifying the source collection.
5. StarterKit
A ready-to-use set of components for a quick start:
- Binders: Quickly connect to the desired component property.
- Value Converters: Transform values for display without altering the ViewModel.
- List Components: Including:
- Virtualized List: Efficiently handles thousands of elements.
- Dynamic ViewModel: For simple structured data without writing a specialized ViewModel.
- View Initialization Components: Initialize Views by ViewModel via the Unity Inspector, with support for popular DI frameworks: Zenject, VContainer.
6. Convenient Debugging:
- View and modify ViewModel state directly in the Unity Inspector, even for plain C# classes.
- [BinderLog] attribute for automatic logging of value changes.
- Clear visual errors in the editor for incorrect bindings.
7. High Performance
Aspid.MVVM is designed with performance in mind:
- No reflection in bindings.
- No boxing/unboxing when passing values.
- Minimized memory allocations.
8. Extensibility
The framework is easily extensible:
- Create custom binders, converters, components, and more.
- Extend the framework to suit project needs without modifying its core.
9. Cross-Platform Support
Aspid.MVVM works on all Unity-supported platforms:
- PC, mobile devices, consoles.
- Create different Views for different platforms without changing the ViewModel or business logic.
Who is Aspid.MVVM For?
- Unity Developers, who want to:
- Simplify maintenance of complex UI and other presentations.
- Improve code structure, avoiding "spaghetti code" in large projects.
- Achieve an architecture suitable for testing and extension.
- Teams, aiming to:
- Enable parallel work for designers and developers.
- Implement modular development and testing.
- Build scalable applications.
- Projects, where the following are critical:
- Flexibility in adapting to changing requirements.
- Robust architecture.
- High performance.
Aspid.MVVM makes MVVM in Unity not only possible but also convenient.
