Home

Forsetti Framework Wiki

Forsetti is a native Apple modular runtime framework for iOS and macOS applications. It gives host apps a consistent way to discover, validate, unlock, activate, and render feature modules while keeping architecture boundaries strict and enforceable.

Current architecture emphasizes:

• Shell-owned UI guardrails (module UI is additive through approved contribution surfaces).
• Contract-first module boundaries and runtime policy gates.
• Multi-module runtime state with explicit UI module selection.

Start Here

• New to Forsetti: Repository README
• Integrating into an app: Developer Guide
• Building or reviewing runtime integrations: Runtime API Reference
• Enforcing architecture and OOP guardrails: Forsetti Developer Guide
• Building modules: 8 Module Authoring Guide
• Runtime setup: 7 Runtime Bootstrapping

Wiki Map

Foundations

• 1 Scope and Audience
• 2 Integration Contract (Non-Negotiable)
• 3 Core Design Principles
• 4 Public Concepts and Mental Model
• 5 Package Integration Patterns
• 6 Recommended App Architecture

Implementation

• 7 Runtime Bootstrapping
• 8 Module Authoring Guide
• 9 Manifest Contract Deep Dive
• 10 UI Contributions Model
• 11 Entitlements and Monetization
• 12 Capability Governance
• 13 Services and Dependency Injection
• 14 Eventing Patterns

Operations

• 15 Quality Gates in Consumer Repositories
• 16 Testing Strategy
• 17 Security and Privacy Guidance
• 18 Performance and Reliability Tips
• 19 Troubleshooting
• 20 Upgrade and Change Management
• 21 Pre-PR Checklist
• 22 Quick Reference

Repository References

• Repository README
• Runtime API Reference
• Repository Structure and Tooling
• License

Source of Truth

Wiki content is derived from repository docs and source:

• README.md
• guide.md
• developer-guide.md
• wiki.md
• Package.swift
• Sources/
• Tests/
• Scripts/
• .github/workflows/