Skip to content

Commit f6b0f49

Browse files
authored
docs: Merge pull request #22527 from unoplatform/dev/juno/updated-uno-phil
docs: Enhance philosophy overview of Uno Platform
2 parents a6bfd45 + e3b8cd9 commit f6b0f49

File tree

2 files changed

+175
-16
lines changed

2 files changed

+175
-16
lines changed

build/cSpell.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,8 @@
130130
"xunit",
131131
"Raygun",
132132
"waitlist",
133-
"subviews"
133+
"subviews",
134+
"Agentic"
134135
],
135136
"ignoreWords": [
136137
"ADAL",

doc/articles/concepts/overview/philosophy-of-uno.md

Lines changed: 173 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,30 +4,188 @@ uid: Uno.Overview.Philosophy
44

55
# Philosophy of Uno Platform
66

7-
This document outlines the philosophy of Uno Platform. It guides the development of past and future major architectural decisions.
7+
## Mission
88

9-
## Leverage existing tools
9+
**To empower developers to build pixel-perfect, single-codebase applications for Windows, WebAssembly, iOS, macOS, Android, and Linux.**
1010

11-
We stand on the shoulders of giants, Microsoft's tooling is a treat to work with:
11+
Uno Platform is committed to providing tools for developers to efficiently create high-quality, native-feeling applications across all modern platforms from a unified codebase.
1212

13-
- [Edit and Continue](https://learn.microsoft.com/visualstudio/debugger/edit-and-continue)
14-
- [Live Visual Tree](https://learn.microsoft.com/visualstudio/debugger/inspect-xaml-properties-while-debugging)
15-
- [XAML Hot Reload](https://learn.microsoft.com/visualstudio/debugger/xaml-hot-reload?view=vs-2019)
13+
## Vision
1614

17-
The promise of the Uno Platform is to enable building your app with those tools and then deploying it to WebAssembly, iOS, Android, macOS, and Linux.
15+
Uno Platform strives to be the leading cross-platform UI framework enabling .NET developers to reuse their skills and code, thereby shrinking development time and cost while maximizing reach. Our vision is to make true cross-platform UI/UX parity possible—whether deploying to mobile, web, or desktop—with full support for the latest device capabilities, modern tooling including AI, and next-generation development experiences.
1816

19-
## Create pixel-perfect, rich, and responsive UIs
17+
---
18+
19+
## Core Philosophy & Principles
20+
21+
### 1. Leverage Existing Tools and Skills
22+
23+
Uno Platform is built on the foundation of well-established Microsoft technologies—including XAML and C#—so developers can apply the skills they already know instead of learning entirely new paradigms. And because Uno Platform supports development from any operating system, teams can build and ship cross-platform applications using the tools and workflows that fit their environment best.
24+
25+
**Key Benefits:**
26+
27+
- Maximize productivity with cross-OS tooling like C# and XAML Hot Reload, Hot Design for real-time visual editing, AI-powered assistance through Docs MCP and App MCP, and streamlined CLI tools such as uno-check and project templates.
28+
- Build apps using proven Microsoft technologies and deploy to multiple platforms: WebAssembly, iOS, Android, macOS, Windows, and Linux
29+
- Reduce learning curve for .NET developers transitioning to cross-platform development
30+
- Day-0 support for the latest .NET and Visual Studio ecosystems
31+
32+
### 2. AI-Powered Agentic Development
33+
34+
As of 2024-2026, Uno Platform has embraced AI-powered development workflows to dramatically increase developer productivity while maintaining full developer control.
35+
36+
**Innovation Highlights:**
37+
38+
- **Hot Design:** The only visual designer that enables real-time, on-app visual editing and AI-assisted UI creation.
39+
- **AI Agents in Development:** Uno Platform Studio 2.0 (an AI-powered development tool suite) introduces AI assistants like the Hot Design Agent, an AI-powered design assistant that can understand your code, context, and even control the running app to suggest and implement UI changes in real time
40+
- **Human-in-the-Loop:** Developers preview and approve changes, ensuring quality while benefiting from AI assistance
41+
- **MCP Servers:** AI interacts with documentation, APIs, app states, and UI elements live via Model Context Protocol (MCP) servers, providing context-aware assistance
42+
- **App Live Testing:** AI agents can interact with running apps, trigger UI events, and automate testing/debugging with human approval
43+
44+
This approach represents a fundamental shift in how developers work—enabling faster iterations, better design fidelity, and reduced time-to-market without sacrificing code quality or control.
45+
46+
### 3. Pixel-Perfect, Rich, and Responsive UIs
47+
48+
We believe developers shouldn't have to choose between productivity and great design. Uno Platform prioritizes both.
49+
50+
**Our Commitment:**
51+
52+
- Support sophisticated animations, templating, and visual effects
53+
- Achieve responsive, pixel-perfect interfaces that adapt across devices
54+
- Enable designers and developers to work together seamlessly with tools like Figma integration (one-click export from Figma to C# or XAML)
55+
- Provide visual designers with hot reload capabilities on running apps for instant feedback
2056

21-
Developers shouldn't sacrifice application looks for personal productivity. You can have both. Strong support for animations, templating, and custom visual effects is a must. When phones come in all sizes and manufacturers are [gouging holes out of the screen area](https://www.cnet.com/pictures/phones-with-notches/), your application's layout better be responsive and pixel-perfect or today's users, be it in corporate or private setting will not use it.
57+
### 4. Separation of Concerns
2258

23-
## Let views do views
59+
Uno Platform advocates a clear separation between model, view, and presentation logic, promoting MVVM (Model-View-ViewModel) principles.
2460

25-
Separation of model, view, and presentation keeps your code loosely coupled and easy to maintain. Features like data binding and attached properties let you write clean, elegant MVVM-style code.
61+
**Architecture Benefits:**
2662

27-
## Native inter-compatibility (leave an escape hatch)
63+
- Clean, maintainable code using features like data binding and attached properties
64+
- Support for both classic MVVM and modern state management approaches (MVUX)
65+
- Scalable application architecture that grows with your team and project
66+
- Testable code with clear boundaries between business logic and UI
2867

29-
100% code reuse is the ideal, but it must also be easy to access functionality specific to a single platform in case it is a must. Also, a platform must make it easy to incorporate native third-party libraries. Uno Platform is architected to make this possible.
68+
### 5. Native Inter-compatibility
69+
70+
While promoting maximum code reuse as the ideal approach, Uno recognizes the need for platform-specific functionality.
71+
72+
**Flexibility Features:**
73+
74+
- Support "escape hatches" for platform-specific code when needed
75+
- Easy integration of native third-party libraries and APIs
76+
- Ability to call platform-specific APIs directly from shared code
77+
- Hybrid UI scenarios combining web and native elements
78+
79+
### 6. Performance as a Feature
80+
81+
Performance is not an afterthought; it's a primary consideration. We prioritize optimization based on real-world profiling and ongoing enhancements to ensure apps are fast and responsive.
82+
83+
**Performance Focus:**
84+
85+
- Optimized Skia rendering engine for smoother performance
86+
- Hardware-accelerated UI features (e.g., hardware-accelerated shadows)
87+
- Optimized image loading (e.g., offloading decoding to WebWorkers for WebAssembly)
88+
- Continuous profiling and performance improvements in every release
89+
- Prevention of poor user experiences and negative reviews through proactive performance work
90+
91+
---
92+
93+
## Comprehensive Cross-Platform Support
94+
95+
Uno Platform enables building applications for all major platforms from a **single codebase**:
96+
97+
- **Windows** (Win32, UWP, WinUI 3)
98+
- **WebAssembly** (Browser-based, no plugins required)
99+
- **iOS** (iPhone and iPad)
100+
- **Android** (Phones and tablets)
101+
- **macOS** (Native Mac applications)
102+
- **Linux** (GTK-based applications)
103+
- **Embedded devices** (IoT and specialized hardware)
104+
105+
This comprehensive support dramatically lowers maintenance costs and reduces time-to-market for updates and new features.
106+
107+
---
108+
109+
## Enterprise-Grade Tooling & Ecosystem
110+
111+
### Development Tools
112+
113+
- **Visual Studio Integration:** Full support for Visual Studio 2026 (and previous versions)
114+
- **Always on the latest .NET:** Day-0 support for new .NET releases, with preview‑specific builds available for teams who want to stay on the bleeding edge.
115+
- **Hot Reload & Real-Time UI Design:** Visual designer lets you tweak XAML and C# on a running app with instant changes
116+
- **Status Indicators:** Enhanced developer experience with environment health monitoring, restore progress, and SDK validation
117+
118+
### Rich Component Ecosystem
119+
120+
- Seamless integration with **WinUI controls**
121+
- **Windows Community Toolkit**
122+
- **Uno Toolkit** for additional controls and extensions
123+
- **.NET MAUI controls** compatibility
124+
- Hundreds of UI components available out of the box
125+
- Extensive open-source and 3rd party libraries support
126+
127+
### Collaboration Features
128+
129+
- **Figma Integration** for rapid prototyping and design handoff
130+
- **Modern Solution Formats:** Support for the human-readable `.slnx` solution format for easier team collaboration and code reviews
131+
- **Source Control Friendly:** Designed with team development and version control in mind
132+
133+
---
134+
135+
## Open Source and Commercial Flexibility
136+
137+
Uno Platform balances open-source principles with commercial sustainability:
138+
139+
- **Open-Source Foundation:** Free and open-source under the Apache 2.0 license
140+
- **Commercial Tools:** Optional AI-powered workflows and visual designers available
141+
- **Community Edition:** Full access to core platform features
142+
- **Professional Edition:** Advanced features for enterprise teams
143+
- **Educational Support:** Discounts for educational institutions and open-source contributors
144+
145+
---
146+
147+
## Why Uno Platform?
148+
149+
### For Organizations
150+
151+
- **Cost Efficiency:** Single codebase significantly reduces development and maintenance costs compared to platform-specific implementations
152+
- **Faster Time-to-Market:** Deploy to all platforms simultaneously rather than building separately
153+
- **Future-Proof:** Active development, regular updates, and commitment to latest technologies
154+
- **Risk Mitigation:** Open-source foundation ensures you're never locked in
155+
156+
### For Developers
157+
158+
- **Leverage Existing Skills:** Use your C# and XAML knowledge immediately
159+
- **Career Growth:** Cross-platform expertise is highly valued in the market
160+
- **Modern Tooling:** AI-assisted development, hot reload, visual designers
161+
- **Community Support:** Active community, extensive documentation, and commercial support options
162+
163+
### For Teams
164+
165+
- **Unified Codebase:** Frontend and backend teams can work in the same language and ecosystem
166+
- **Design-Developer Collaboration:** Figma integration and visual tools bridge the gap
167+
- **Scalable Architecture:** From prototypes to enterprise applications
168+
- **Quality Assurance:** Single codebase means testing once deploys everywhere
169+
170+
---
171+
172+
## Looking Forward
173+
174+
Uno Platform continues to evolve with the industry, embracing:
175+
176+
- **AI Integration:** Making AI-powered development accessible and productive
177+
- **Modern .NET:** Supporting the latest .NET releases on day-0
178+
- **Performance:** Continuous optimization for better user experiences
179+
- **Developer Experience:** Tools that make developers more productive and happier
180+
- **Platform Expansion:** Supporting emerging platforms and form factors
181+
182+
Our philosophy is simple: **empower developers with the best tools, leverage proven technologies, and never compromise on quality, performance, or developer experience.**
183+
184+
---
30185

31-
## Performance is a feature
186+
## Learn More
32187

33-
The slow antelope gets eaten, and the slow app gets 1-star ratings. We've done a lot of optimization on the basis of profiling in real-world use cases, and we'll continue to do so.
188+
- **Official Website:** [https://platform.uno](https://platform.uno)
189+
- **Documentation:** [https://platform.uno/docs](https://platform.uno/docs)
190+
- **GitHub:** [https://github.com/unoplatform](https://github.com/unoplatform)
191+
- **Community:** [https://discord.gg/eBHZSKG](https://discord.gg/eBHZSKG)

0 commit comments

Comments
 (0)