Add comprehensive project overview documentation

[Copilot]

This PR provides a comprehensive answer to "What is this project about?" by documenting the MAF (Mutation Authority Framework) project's purpose, architecture, and key features.

What was added

The documentation covers:

• Project Purpose: MAF is a server-centric realtime application framework that simplifies state management in realtime apps
• Problem Statement: Addresses the complexity of managing state in realtime applications, where traditional approaches are either too complex (server-side) or insecure (client-side)
• Architecture Overview: Server-authoritative approach using Rust backend with WASM containers and JavaScript/TypeScript client libraries
• Key Features: Realtime state abstractions, WASM deployments, full-stack framework with CLI tools
• Use Cases: Realtime games, chat apps, collaborative tools, live dashboards, quiz applications
• Development Workflow: From writing server logic in Rust to deploying WASM containers and connecting clients

Context

The project lacked a clear, comprehensive explanation of what MAF is and what problems it solves. This documentation synthesizes information from:

• README.md and project structure
• Documentation website content
• Example applications
• Crate descriptions and code comments

The documentation helps newcomers understand MAF's value proposition as a framework that makes realtime application development as straightforward as traditional web development while maintaining security through server authority.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
maf-www	Ready	Preview	Comment	Aug 26, 2025 1:24am