# Apache Maka Primary Supported Platform: macOS Apple Silicon (arm64) Explained > Discover Apache Maka's primary supported platform: macOS Apple Silicon arm64. Learn why it's the only production-grade stable build available for this powerful architecture. - Repository: [The Apache Software Foundation/maka](https://github.com/apache/maka) - Tags: getting-started - Published: 2026-08-22 --- **Apache Maka's primary supported platform is macOS Apple Silicon (arm64), offering the only production-grade stable build while Windows remains a preview target and Linux support is still under development.** Apache Maka is an emerging open-source framework designed for advanced runtime operations and desktop application development. According to the official source code and documentation, the project's primary supported platform is explicitly centered on macOS running on Apple Silicon processors. This focus ensures developers access the most stable APIs and performance optimizations currently available in the codebase. ## Platform Support Hierarchy in Apache Maka The repository maintains a clear hierarchy of platform targets, with macOS arm64 standing as the sole fully supported environment for production deployments. ### macOS Apple Silicon (arm64) — The Production Standard In [`README.md`](https://github.com/apache/maka/blob/main/README.md), the project displays a prominent **"macOS‑arm64"** badge indicating the primary supported target. This architecture receives full CI/CD validation, optimized build pipelines, and complete API compatibility guarantees. Developers deploying on Apple Silicon benefit from the runtime-resume contracts and safe boundary implementations specifically tested on this platform. ### Windows Support Limitations The [`docs/windows-support.md`](https://github.com/apache/maka/blob/main/docs/windows-support.md) file explicitly clarifies that Windows is **"an active enablement target, not a fully supported Maka platform."** While the codebase includes Windows compatibility layers, these remain experimental and lack the stability guarantees of the macOS build. Organizations requiring production reliability should avoid deploying on Windows until official support status changes. ### Linux Development Status According to [`docs/architecture/runtime-resume-phase1-safe-boundary-contract.md`](https://github.com/apache/maka/blob/main/docs/architecture/runtime-resume-phase1-safe-boundary-contract.md), Linux appears alongside macOS as a "primary support target" in architectural planning. However, the current implementation lacks a stable, production-grade build for Linux distributions, making macOS the only viable option for immediate production deployments. ## Source Code Evidence for Platform Prioritization The repository structure reveals platform priorities through specific documentation files and build configurations. **README.md Badging** The front-page documentation prominently displays the macOS arm64 badge as the lead platform, establishing immediate visual confirmation of the primary supported platform for new contributors and users evaluating the technology stack. **Windows Support Caveats** As documented in [`docs/windows-support.md`](https://github.com/apache/maka/blob/main/docs/windows-support.md), Windows functionality remains in active development with explicit warnings that it does not constitute a fully supported Maka platform. The documentation states that Windows support is intended for testing and contribution purposes only, not production workloads. **Architecture Contracts** The [`docs/architecture/runtime-resume-phase1-safe-boundary-contract.md`](https://github.com/apache/maka/blob/main/docs/architecture/runtime-resume-phase1-safe-boundary-contract.md) references macOS as the validated environment for safe boundary contracts, indicating that core security and runtime features receive primary testing on Apple Silicon hardware before other platforms. ## Development Workflow on macOS Apple Silicon To leverage the primary supported platform, developers should follow the macOS-specific build procedures verified in the source repository. **Clone and Install** ```bash # Clone the repository git clone https://github.com/apache/maka.git cd maka # Install dependencies optimized for macOS Apple Silicon npm ci ``` **Launch Development Environment** ```bash # Start the desktop UI on macOS npm run dev ``` **Run CLI Operations** ```bash # Execute CLI commands on the primary supported platform npm run cli:dev -- run "Summarize this repository" ``` These commands assume an arm64 Darwin environment, matching the hardware architecture where Maka achieves optimal performance and stability. ## Summary - **macOS Apple Silicon (arm64)** is Apache Maka's sole production-grade supported platform according to repository documentation and build configurations. - **Windows support** remains experimental and explicitly marked as not fully supported in [`docs/windows-support.md`](https://github.com/apache/maka/blob/main/docs/windows-support.md). - **Linux** appears in architectural planning as a future primary target but currently lacks stable implementation. - Developers seeking reliability should deploy exclusively on macOS arm64 hardware using the validated `npm` workflows. ## Frequently Asked Questions ### Is Windows fully supported by Apache Maka? No. According to [`docs/windows-support.md`](https://github.com/apache/maka/blob/main/docs/windows-support.md), Windows is only an active enablement target and preview environment, not a fully supported Maka platform. Production deployments on Windows are not recommended at this time. ### Does Apache Maka support Linux? While [`docs/architecture/runtime-resume-phase1-safe-boundary-contract.md`](https://github.com/apache/maka/blob/main/docs/architecture/runtime-resume-phase1-safe-boundary-contract.md) lists Linux as a planned primary support target alongside macOS, the platform currently lacks a stable, production-grade build. macOS Apple Silicon remains the only fully supported option for production use. ### Why is macOS Apple Silicon prioritized over Intel-based Macs? The repository specifically highlights **macOS‑arm64** (Apple Silicon) in the [`README.md`](https://github.com/apache/maka/blob/main/README.md) badge system, indicating that ARM64 architecture receives priority optimization, testing, and CI/CD validation. While Intel-based macOS may function, it does not carry the primary supported designation reserved for Apple Silicon. ### How can I verify my current platform supports Apache Maka? Check your system architecture using `uname -m` on macOS. If the output returns `arm64` and you are running macOS, you are on the primary supported platform. The `npm ci` command will automatically pull Apple Silicon-optimized dependencies when running on compatible hardware.