asterios / app

2.19.0 2026-07-31 16:59 UTC

Requires

• php: ^8.3
• ext-ctype: *
• ext-intl: *
• asterios/core: ^2

MIT

• Benjamin Butschko
• Jörg Heinrich

Published on Packagist.org on 2026-07-31 17:00 UTC

README

AsteriosPHP scaffold

This repository contains the default scaffold for AsteriosPHP.
The source code for the framework itself can be found at asteriosframework/core.

composer create-project asterios/app

🚀 Getting Started

composer create-project asterios/app my-asterios-app
cd my-asterios-app
php -S localhost:8000

👉 That's it.
All frontend assets (Tailwind CSS) are automatically installed and built during composer install.

⚙️ Environment Configuration

On first install, Asterios automatically creates a .env file.

.env
.env.example

• .env.example → template committed to the repository
• .env → your local configuration (generated automatically)

👉 The .env file is created during:

php asterios install

You can safely modify your .env file for:

• database credentials
• app environment
• custom configuration

📁 Project Structure

app/                     # Application logic (Controllers, Services, etc.)
assets/css/              # Tailwind source files
cache/                   # Cache directory
config/                  # Configuration files
database/                # Migrations and seeders
logs/                    # Log files
public/                  # Public files
templates/               # Email templates
views/                   # Twig templates

🧠 App Layer

app/
├── Contracts/          
├── Controller/         
├── Data/               
├── Enums/              
├── Exceptions/         
├── Middleware/         
├── Models/             
├── Repositories/       
├── Service/            
├── Support/            
├── Traits/             

🧰 Asterios CLI

AsteriosPHP ships with a built-in CLI tool.

From the project root, you can run commands directly.

Make sure the file is executable:

chmod +x asterios

Run commands via:

asterios <command>

No php prefix is required.

📊 System

asterios about
asterios list

🗄 Database

asterios migrate
asterios migrate:status
asterios db:seed

🧪 Test Data

asterios fake:bank
asterios fake:uuid

⚙️ Setup

asterios install

🏗 Code Generation

asterios make:model
asterios make:migration
asterios make:seeder

🖼 View / Twig

php asterios view:cache
php asterios view:clear

🎨 Frontend (Tailwind CSS)

This project uses Tailwind CSS only.

📁 Structure

assets/css/asterios-app.css
public/assets/css/asterios-app.css
tailwind.config.js

⚙️ Build Commands

Development (watch mode)

npm run dev

Production build

npm run build

🔁 Via Composer

composer dev-assets
composer build-assets

🤖 Automatic Setup

On install/update:

• npm install
• npm run build

🧱 Twig Components

views/components/

Example:

{% include "components/button.twig" with { label: "Click me" } %}

🎨 Design System

Defined in:

assets/css/asterios-app.css

Example:

@layer components {
  .btn-primary {
    @apply inline-block px-8 py-3 rounded-full font-medium text-white 
           bg-gradient-to-br from-primary to-secondary 
           hover:opacity-90 transition;
  }
}

⚙️ Tailwind Config

tailwind.config.js

Example:

extend: {
  colors: {
    primary: "#0d6efd",
    secondary: "#20c997"
  }
}

💡 Customize

Edit:

tailwind.config.js
assets/css/asterios-app.css

Add components:

views/components/*.twig

🧠 Philosophy

• No Bootstrap
• Tailwind only
• Twig components
• Clean architecture
• Built-in CLI
• Environment-based configuration
• Zero-config setup via Composer

📦 Requirements

• PHP 8.3+
• Node.js

❤️ AsteriosPHP

https://asteriosphp.de