PHPackages                             asterios/app - 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. asterios/app

ActiveProject[Framework](/categories/framework)

asterios/app
============

Scaffold App for AsteriosPHP. AsteriosPHP is a simple and flexible PHP 8.+ framework, inspired from the best features of other frameworks, in a modern and elegant way.

2.14.0(1w ago)0421MITPHPPHP ^8.3

Since Feb 17Pushed 1w agoCompare

[ Source](https://github.com/asteriosframework/asterios-app)[ Packagist](https://packagist.org/packages/asterios/app)[ Docs](https://www.asteriosphp.de)[ RSS](/packages/asterios-app/feed)WikiDiscussions develop Synced 2d ago

READMEChangelog (10)Dependencies (6)Versions (29)Used By (0)

 [ ![](https://camo.githubusercontent.com/adaff1875d64bbd080c85cc8fbea2a8a93ce6b1657cc1052ab8f222945a24814/68747470733a2f2f6173746572696f737068702e64652f6173736574732f6d656469612f696d616765732f6173746572696f737068702532306c6f676f2e706e67) ](https://asteriosphp.de)

AsteriosPHP scaffold
====================

[](#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
=================

[](#-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
============================

[](#️-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
===================

[](#-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-layer)

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

```

---

🧰 Asterios CLI
==============

[](#-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
```

No php prefix is required.

📊 System
--------

[](#-system)

```
asterios about
asterios list
```

🗄 Database
----------

[](#-database)

```
asterios migrate
asterios migrate:status
asterios db:seed
```

🧪 Test Data
-----------

[](#-test-data)

```
asterios fake:bank
asterios fake:uuid
```

⚙️ Setup
--------

[](#️-setup)

```
asterios install
```

🏗 Code Generation
-----------------

[](#-code-generation)

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

🖼 View / Twig
-------------

[](#-view--twig)

```
php asterios view:cache
php asterios view:clear
```

---

🎨 Frontend (Tailwind CSS)
=========================

[](#-frontend-tailwind-css)

This project uses **Tailwind CSS only**.

📁 Structure
-----------

[](#-structure)

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

```

---

⚙️ Build Commands
-----------------

[](#️-build-commands)

### Development (watch mode)

[](#development-watch-mode)

```
npm run dev
```

### Production build

[](#production-build)

```
npm run build
```

---

🔁 Via Composer
--------------

[](#-via-composer)

```
composer dev-assets
composer build-assets
```

---

🤖 Automatic Setup
-----------------

[](#-automatic-setup)

On install/update:

- npm install
- npm run build

---

🧱 Twig Components
=================

[](#-twig-components)

```
views/components/

```

Example:

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

---

🎨 Design System
===============

[](#-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)

```
tailwind.config.js

```

Example:

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

---

💡 Customize
===========

[](#-customize)

Edit:

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

```

Add components:

```
views/components/*.twig

```

---

🧠 Philosophy
============

[](#-philosophy)

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

---

📦 Requirements
==============

[](#-requirements)

- PHP 8.3+
- Node.js

---

❤️ AsteriosPHP
==============

[](#️-asteriosphp)

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance98

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 99% 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 ~5 days

Total

25

Last Release

13d ago

Major Versions

1.5.2 → 2.0.02026-04-09

PHP version history (2 changes)1.0.0PHP >=8.3

1.2.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/86a3ecd4d3d50f85a9eaa6c80914393838161178bbc1b0c9f32f2014a0a1bfba?d=identicon)[asteriosphp](/maintainers/asteriosphp)

---

Top Contributors

[![asteriosphp](https://avatars.githubusercontent.com/u/213940657?v=4)](https://github.com/asteriosphp "asteriosphp (100 commits)")[![benbutschko](https://avatars.githubusercontent.com/u/184115149?v=4)](https://github.com/benbutschko "benbutschko (1 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

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

173.2k](/packages/nineinchnick-edatatables)[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)