PHPackages                             vortos/vortos - 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. vortos/vortos

ActiveProject[Framework](/categories/framework)

vortos/vortos
=============

The Vortos Clean Architecture Framework — project skeleton

v1.0.0-alpha-99(2mo ago)099MITPHP >=8.2

Since Apr 25Compare

[ Source](https://github.com/Vortos/vortos)[ Packagist](https://packagist.org/packages/vortos/vortos)[ RSS](/packages/vortos-vortos/feed)WikiDiscussions Synced 3w ago

READMEChangelogDependencies (2)Versions (47)Used By (0)

Vortos Application Skeleton
===========================

[](#vortos-application-skeleton)

Installation
------------

[](#installation)

```
composer create-project vortos/vortos my-app
cd my-app
```

Composer runs the Vortos setup wizard after project creation. The wizard can configure Docker or local development and writes machine-specific values to `.env.local`.

In interactive Linux/macOS terminals, setup supports arrow-key selection. In CI, Windows, or non-interactive shells, it falls back to the standard prompt and command flags.

Run it again any time:

```
php vortos setup
```

Environment Files
-----------------

[](#environment-files)

Commit `.env` and `.env.example` with safe shared defaults. Do not commit `.env.local`, `.env.*.local`, `.vortos-setup.json`, or `*.bak.*`.

`php vortos setup` writes generated secrets, service URLs, and local driver choices to `.env.local`. Edit `.env.local` only for your own machine-specific overrides.

Docker development files load `.env` first and `.env.local` second. Keep generated Docker passwords in `.env.local`; do not copy them into `.env`.

Setup does not rewrite `config/*.php`. Config files stay stable as override points. Framework modules read `VORTOS_*` env defaults from `.env.local`; if no env driver is selected, cache and messaging use in-memory drivers.

Framework modules read agnostic env names such as `VORTOS_WRITE_DB_DSN`, `VORTOS_READ_DB_DSN`, `VORTOS_CACHE_DSN`, and `VORTOS_MESSAGING_DSN`. Docker images may still need vendor-specific env such as `POSTGRES_PASSWORD`, but those are only for service bootstrap.

Setup Profiles
--------------

[](#setup-profiles)

Use profiles for the common paths:

```
php vortos setup --profile=docker
php vortos setup --profile=minimal
```

Interactive setup asks for a profile first, then shows a review step with `Continue`, `Customize`, or `Cancel`.

Choose `Customize` when you want to choose each setup category before files are written:

- runtime
- write database
- read database
- cache
- messaging

Some categories have only one supported option today. They still appear in the custom flow so future package choices can fit into the same setup path without changing the command shape.

Setup choices come from registered capabilities. Vortos modules can add options by registering a `SetupCapabilityInterface` service tagged with `vortos.setup_capability`.

Capability keys use `category.option`, for example:

- `write_db.mysql`
- `read_db.postgres`
- `cache.memcached`
- `messaging.rabbitmq`

The capability makes the option appear in setup. The module still provides the real services, config defaults, environment mapping, Docker files, migrations, and tests behind that option.

Runtime Presets
---------------

[](#runtime-presets)

Use presets when you want a specific runtime:

```
php vortos setup --preset=docker-frankenphp
php vortos setup --preset=docker-phpfpm
php vortos setup --preset=local
php vortos setup --preset=minimal
```

Use `--dry-run` to preview generated environment and Docker changes without writing files:

```
php vortos setup --profile=docker --dry-run --no-interaction
```

Docker Development
------------------

[](#docker-development)

For Docker presets, setup publishes the selected runtime files. Start the environment with:

```
php vortos up
```

Local Development
-----------------

[](#local-development)

For local presets, setup configures in-memory cache and messaging by default:

```
php vortos setup --profile=minimal
php -S 127.0.0.1:8000 -t public
```

Useful Commands
---------------

[](#useful-commands)

```
php vortos list
php vortos test
php vortos migrate:publish
php vortos migrate
```

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance88

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

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 ~1 days

Total

46

Last Release

60d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d4a94fd7127f8bdb58b2bb2249a140569a584b67b2df184f1e8594b497d397e2?d=identicon)[Sachintha-De-Silva](/maintainers/Sachintha-De-Silva)

### Embed Badge

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

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

###  Alternatives

[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[alizharb/laravel-modular

A professional, framework-agnostic modular architecture for Laravel 11+. Features zero-config autoloading, 29+ Artisan command overrides, and seamless Vite integration.

211.6k9](/packages/alizharb-laravel-modular)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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