# MyronCMS

MyronCMS is a designer-governed, template-driven, AI-native content management system for the modern web. The OS Core distribution is the public, self-hosted foundation; paid first-party Modules and private service infrastructure are delivered outside the Core package.

## OS Core

The OS Core package includes the PHP application runtime under `app/`, the root routing files required for a normal hosted install, and the packaged resources needed for a fresh Core site.

Core includes:

- browser-based first-run installation with database verification, safe `.env` generation, custom administrator path selection, and first administrator creation;
- silent Core install posture with no license activation, install callback, telemetry, community ping, or remote registration requirement;
- governed design-system and JSONM runtime resources, including packaged archetypes, components, templates, site types, and install-time bootstrap data;
- Design, Content, Administration, Files, Search, Extensions, and License Manager surfaces appropriate to the Core package;
- public rendering for template-governed pages, shared content, navigation, footer/chrome resolution, SEO metadata, sitemaps, robots, `llms.txt`, feeds, and Markdown/AI crawler content negotiation;
- native forms/mail substrate, verified notification destinations, blog comments with moderation, public site mode controls, media delivery, WebP sidecars, search substrate, update-package validation, and audit/event recording;
- deterministic APIs and MCP-oriented contracts for governed operations, bounded by local scopes and administrator configuration;
- local Extension v1 registration and authenticated third-party Extension install surfaces where signed packages are explicitly made available.

## Install Layout

Upload the complete public build package into the website document root for the domain. The root `index.php` and `.htaccess` files own public routing, while `app/` remains the internal runtime payload.

After installation:

- the public website runs at `/`;
- the admin runs at the custom path selected during setup;
- visiting `/` renders the public website, even when an administrator is logged in;
- `/app` is not the visitor-facing website URL.

Copy `.env.example` to `.env` only for manual local setup. Browser-based setup can generate `.env` after validating the MySQL/MariaDB connection. Most hosted MySQL environments use database port `3306`; MAMP often uses `8889`.

## License

The selected launch posture for the MyronCMS OS Core distribution is AGPL-3.0-only. See [LICENSE.txt](LICENSE.txt) for the complete GNU Affero General Public License version 3 text.

This OS Core license posture is the published result of operator/legal signoff for the public Core grant.

The public Core license applies only to the curated OS Core distribution. It does not grant rights to private development materials, private service infrastructure, secrets, runtime state, local Command Deck data, generated reports, disposable local noise, or paid first-party Module packages that are intentionally excluded from the Core package.

## Direction

MyronCMS is built to provide:

- designer-owned design systems, components, templates, and creative primitives;
- content-managed sites built from governed templates and structured content contracts;
- intuitive operator workflows for pages, assets, forms, search, analytics, and site operations;
- accessibility, privacy, SEO/AEO, performance, and portability as first-class product defaults;
- native AI collaboration through deterministic APIs and MCP instead of brittle code editing;
- a clean extension path through the Extensions SDK rather than direct core modification.
