# Megamono · Keep the whole system in view.

Megamono gives growing repositories a shared structure for applications, documentation, boundaries, automation, and the people and agents changing them.

## The repository is a product, too.

### Structure should explain itself.

Projects, tags, docs, and boundaries form one legible system for people, agents, and automation.

### Adopt without starting over.

Survey the repository you already have, resolve only real ambiguity, and preserve repository-owned decisions.

### Generate the repeatable parts.

Scaffolds encode the conventions that should remain consistent while leaving product code in your hands.

## Capabilities

- Workspace adoption

- Application scaffolds

- Nx project inference

- Repository governance

- Documentation lifecycle

- Boundary linting

- Affected CI

- Workspace health

## Start with the repo you have.

Survey first. Make ambiguity visible. Apply a reviewed plan. Then use the same primitives to keep growing.

### New workspace

```sh
npx create-megamono my-workspace --package-manager=npm
```

Start with applications, shared code, and conventions that fit together.

[Workspace setup →](https://megamono.com/docs/cli/create-megamono)

### Existing Nx workspace

```sh
npm install -g @megamono/cli
```

Bring the repository you already have into a structure you can grow.

[Adoption walkthrough →](https://megamono.com/docs/workflows/adoption)

[Check workspace requirements →](https://megamono.com/docs/workflows/requirements)

Every Megamono package is MIT licensed and works without a subscription.

### Survey

See projects, platforms, toolchains, documentation, and conflicts before Megamono writes a file.

```sh
megamono init --survey
```

### Adopt

Select the governance modules that fit the repository and keep existing ownership explicit.

```sh
megamono init
```

### Grow

Add applications and infrastructure through the same conventions available to new workspaces.

```sh
megamono add app web
```

### Verify

Check the graph, tags, managed artifacts, package alignment, and durable repository rules together.

```sh
npm exec -- nx run megamono:check
```

## Learn the system by changing it.

[Full documentation](https://megamono.com/docs)

- [Adopt an existing workspace](https://megamono.com/guides/adopt-an-existing-workspace): Survey first, resolve only real ambiguity, and bring Megamono into a repository without erasing its history.

- [Add applications without adding drift](https://megamono.com/guides/add-applications-without-drift): Add applications with consistent ports, project tags, tests, and workspace configuration.

- [Give people and agents the same map](https://megamono.com/guides/give-people-and-agents-the-same-map): Treat documentation, durable decisions, and structural checks as part of the workspace rather than an afterthought.

## One graph. More of your stack.

### Apple

Build Swift and Xcode projects alongside the rest of your product.

[Apple docs →](https://megamono.com/docs/platforms/apple)

### Cargo

Keep Rust crates and native applications connected to the workspace.

[Cargo docs →](https://megamono.com/docs/platforms/cargo)

### Cloudflare

Bring Workers, bindings, and edge services into the same project graph.

[Cloudflare docs →](https://megamono.com/docs/platforms/cloudflare)

### Browser extensions

Grow extensions alongside the applications and shared code they use.

[Extension docs →](https://megamono.com/docs/platforms/extension)

### Render

Connect deployment configuration to the projects it builds and runs.

[Render docs →](https://megamono.com/docs/platforms/render)

### Laravel & NativePHP

Organize Laravel services and NativePHP desktop or mobile apps in one workspace.

[Laravel docs →](https://megamono.com/docs/platforms/laravel) · [NativePHP docs →](https://megamono.com/docs/platforms/phpnative)

## Clear layers. Better handoffs.

- [Megamono](https://megamono.com/#workflow) · Repository: Creates and governs the workspace structure everything else builds on.

- [Playstack](https://playstack.dev) · Product: Adds composable product capabilities inside the applications Megamono places.

- [Springbar](https://springbar.app) · Runtime: Runs local applications and services as one inspectable development environment.

## Build the product. Keep the architecture.

[View the repository](https://github.com/megamono-dev/megamono)