PHPackages                             z77/docs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. z77/docs

ActiveLibrary[Framework](/categories/framework)

z77/docs
========

z77 framework documentation — AI-optimized handbook, ADRs and per-area topic docs. Install as require-dev to give an AI coding assistant full framework context inside the project.

1.2.0(1mo ago)033↓50%MITShell

Since Jul 16Pushed 1mo agoCompare

[ Source](https://github.com/z77-ch/docs)[ Packagist](https://packagist.org/packages/z77/docs)[ Docs](https://github.com/z77-ch/z77-framework)[ RSS](/packages/z77-docs/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (6)Used By (0)

z77 Framework 1.0.0 — Documentation
===================================

[](#z77-framework-100--documentation)

Welcome. This documentation serves two purposes:

1. **Knowledge transfer** — Successors and new developers understand the system
2. **Development** — New features are planned and implemented in a structured way

---

Start Here
----------

[](#start-here)

**New to the project?** → [01-handbook/onboarding.md](01-handbook/onboarding.md)

**Claude Code?** → [../CLAUDE.md](../CLAUDE.md)

---

Structure
---------

[](#structure)

### [01-handbook/](01-handbook/) — Knowledge Transfer

[](#01-handbook--knowledge-transfer)

Everything a new developer needs to understand the system and work with it. Two layers: **Reference** (understand the system) and the **Cookbook** (step-by-step recipes — what a project follows when building).

**Reference — understand the system**

DocumentContent[onboarding.md](01-handbook/onboarding.md)Day 1: What is this, where is what, how do I start[dev-environment.md](01-handbook/dev-environment.md)Toolchain setup &amp; verification (PC switch): tools, SSH/gh access, post-sync steps + `verify-dev-env.sh`[architecture.md](01-handbook/architecture.md)How the framework is structured[conventions.md](01-handbook/conventions.md)Coding standards, namespaces, file names[css-conventions.md](01-handbook/css-conventions.md)CSS/SCSS standards: BEM, tokens, components[templates.md](01-handbook/templates.md)Template layer: location, context injection, partials[installer.md](01-handbook/installer.md)Composer installer: configuration, generated files, directory structure[vision.md](01-handbook/vision.md)Why this framework, goals, scope**Cookbook — build recipes (for projects)**

RecipeContent[create-module.md](01-handbook/create-module.md)Step-by-step: Creating a new module[create-page.md](01-handbook/create-page.md)Step-by-step: Creating a new page (routing → action → assets → rendering)[dms-images.md](01-handbook/dms-images.md)Image-size profiles config + displaying DMS images (`mediaUrl`/`mediaImage`)[patterns/](01-handbook/patterns/README.md)Reusable project components (slider, …) + graduation lifecycle### [topics/](topics/) — Single Source of Truth per Work Area

[](#topics--single-source-of-truth-per-work-area)

One file per work area: entry points, file map, mental model, rules, known issues, pendenzen. **Read the matching topic doc before writing or analyzing code in that area.**Structure is enforced by `npm run docs:check` ([docs-lint/STANDARD.md](../docs-lint/STANDARD.md)).

#### Topic trigger map

[](#topic-trigger-map)

You are working on / keywordsReadbackend, dashboard, service panel, user preferences, system pages[topics/backend.md](topics/backend.md)backup, restore, cron, z77-backup CLI[topics/backup.md](topics/backup.md)content block types[topics/block-types.md](topics/block-types.md)bootstrap, DI container, debug flag[topics/bootstrap.md](topics/bootstrap.md)cache, DataCache, APCu, page cache[topics/cache.md](topics/cache.md)content, structured content, content files[topics/content.md](topics/content.md)CSS/SCSS backend, werkbank[topics/css-backend.md](topics/css-backend.md)CSS/SCSS dms[topics/css-dms.md](topics/css-dms.md)CSS/SCSS frontend, public design[topics/css-frontend.md](topics/css-frontend.md)CSS watch, `npm run watch` / `build`[topics/css-watch.md](topics/css-watch.md)documents, DMS, drive, upload, delivery[topics/documents.md](topics/documents.md)entities, hydration, entity data handling[topics/entity-data-handling.md](topics/entity-data-handling.md)fetch, AJAX, CSRF, form validation[topics/fetch.md](topics/fetch.md)i18n, languages, locale switching[topics/i18n.md](topics/i18n.md)installer, `composer install`, project setup[topics/installer.md](topics/installer.md)login, auth, session, AccessGuard[topics/login.md](topics/login.md)mail, email, e-mail versand / configure email sending, SMTP, contact form / kontaktformular, form mail, emailConfig, sender / from address, EmailService, backend mail settings[topics/mail.md](topics/mail.md)messages, flash messages[topics/messages.md](topics/messages.md)metadata, SEO[topics/metadata.md](topics/metadata.md)navigation[topics/navigation.md](topics/navigation.md)packaging, monorepo split, Packagist, release/tagging[topics/packaging.md](topics/packaging.md)persistence design, repositories, drivers[topics/persistence-architecture.md](topics/persistence-architecture.md)file driver, JSON storage[topics/persistence-file.md](topics/persistence-file.md)routing, router, Request, ControllerHandler[topics/routing.md](topics/routing.md)security, hardening, setup token, password policy[topics/security.md](topics/security.md)stylesheet, asset pipeline, AssetCleaner[topics/stylesheet.md](topics/stylesheet.md)translation, Translator[topics/translation.md](topics/translation.md)tree, hierarchy[topics/tree.md](topics/tree.md)view layer, partials, HtmlView[topics/view-layer.md](topics/view-layer.md)templates (create/change)[01-handbook/templates.md](01-handbook/templates.md)### [02-decisions/](02-decisions/) — Architecture Decision Records (ADRs)

[](#02-decisions--architecture-decision-records-adrs)

Why was X built this way and not another? Every important decision has its own document. Prevents successors from reversing decisions that have already been thought through.

### [03-development/](03-development/) — Feature Lifecycle

[](#03-development--feature-lifecycle)

New features from idea to implementation.

Document/FolderContent[roadmap.md](03-development/roadmap.md)Milestones and priorities[triage.md](03-development/triage.md)Process: when is what addressed[ideas/](03-development/ideas/)Raw ideas — not yet evaluated[concepts/](03-development/concepts/)Elaborated concepts — under discussion[specs/](03-development/specs/)Technical specs — approved, ready for implementation### [04-changelog/](04-changelog/) — Version History

[](#04-changelog--version-history)

---

External Packages (z77 vendor, outside this repo)
-------------------------------------------------

[](#external-packages-z77-vendor-outside-this-repo)

Vendor/domain integrations are separate repositories — never part of this monorepo (see [ADR-027](02-decisions/adr-027-vendor-integrations-as-external-packages.md)). The Composer vendor `z77` is branding, not location. Currently:

PackageContentLicense`z77/propbase`PropBase (myprop.ch) real-estate API core — framework-agnostic, own repo + docsproprietary → MIT planned`z77/module-propbase`z77 adapter for PropBase (controllers, presenters, templates) — plannedproprietaryProjects consume these via Composer (path repository in development).

---

Status Conventions
------------------

[](#status-conventions)

StatusMeaning`[IDEA]`Raw idea, not yet evaluated`[CONCEPT]`Elaborated, under discussion`[APPROVED]`Spec approved, implementation can start`[IN PROGRESS]`Currently being implemented`[DONE]`Implemented and in production`[REJECTED]`Deliberately not pursued further (with reason)

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance91

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

44d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6251635?v=4)[z77](/maintainers/z77)[@z77](https://github.com/z77)

---

Top Contributors

[![z77-ch](https://avatars.githubusercontent.com/u/239538121?v=4)](https://github.com/z77-ch "z77-ch (2 commits)")

---

Tags

phpframeworkdocumentationaiclaudez77

### Embed Badge

![Health badge](/badges/z77-docs/health.svg)

```
[![Health](https://phpackages.com/badges/z77-docs/health.svg)](https://phpackages.com/packages/z77-docs)
```

###  Alternatives

[laravel/agent-detector

Detect if code is running in an AI agent or automated development environment

8311.2M48](/packages/laravel-agent-detector)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
