vortexphp/vortex

Lightweight PHP application stack (app/, engine/, config, assets)

v0.5.0 2026-04-03 19:28 UTC

Requires

• php: ^8.2
• vortexphp/framework: ^0.5

Suggests

• ext-openssl: SMTP STARTTLS / ssl:// (MAIL_ENCRYPTION tls or ssl)

MIT

README

Minimal startup-ready PHP app on vortexphp/framework.

Requirements

• PHP 8.2+
• Composer
• Node.js + npm (for Tailwind CSS build)

Create Project

composer create-project vortexphp/vortex my-app
cd my-app
npm install
cp .env.example .env

Install (existing clone)

composer install
npm install
cp .env.example .env

Generate APP_KEY and put it in .env:

php -r "echo 'base64:'.base64_encode(random_bytes(32)), PHP_EOL;"

Set at least:

• APP_KEY
• APP_URL (for local: http://localhost:8000)

Run Locally

Build CSS once:

npm run build

Run the app:

php vortex serve

Open:

• http://localhost:8000/
• http://localhost:8000/health

Useful Commands

composer run doctor
composer run smoke
composer run db-check

Production Install

composer run install:prod
npm run build