avelpress/avelpress

AvelPress is a framework for creating WordPress plugins based on Laravel. It includes support for database (Laravel Eloquent), Controllers, Validator, Routes, and more.

v1.0.2 2025-10-28 20:23 UTC

MIT

• Marcos Gomes Neto

README

A powerful Laravel-inspired framework for WordPress plugin and theme development

📚 Official Documentation

📦 View on Packagist

AvelPress brings the elegance and power of Laravel's architecture to WordPress development. Build robust, maintainable plugins and themes using familiar patterns like Eloquent ORM, Service Providers, Facades, and more.

✨ Features

• 🏗️ Laravel-inspired Architecture - Familiar MVC patterns and structure
• 🗄️ Eloquent-style ORM - Powerful database interactions with models and relationships
• 🛤️ Elegant Routing - Clean API routing with middleware support
• 🔧 Service Container - Dependency injection and service providers
• 📦 CLI Tool - Generate projects, migrations, and boilerplate code
• 🔄 Database Migrations - Version control for your database schema
• 🎨 Blade-like Templates - Clean templating system
• ✅ Validation - Built-in request validation
• 🎭 Facades - Static-like interfaces to dynamic objects

🚀 Quick Start

Installation

Install the AvelPress CLI globally:

composer global require avelpress/avelpress-cli

Or Install locally

composer require avelpress/avelpress-cli --dev

Create Your First Plugin

# Create a new plugin
avel new acme/my-awesome-plugin

# if installed locally
./vendor/bin/avel new acme/my-awesome-plugin

# Navigate to the project
cd acme-my-awesome-plugin

# Install dependencies
composer install

Project Structure

acme-my-awesome-plugin/
├── acme-my-awesome-plugin.php    # Main plugin file
├── composer.json
├── assets/
├── src/
│   ├── app/
│   │   ├── Controllers/          # HTTP Controllers
│   │   ├── Models/              # Eloquent Models
│   │   ├── Providers/           # Service Providers
│   │   └── Services/            # Business Logic
│   ├── bootstrap/
│   │   └── providers.php        # Register providers
│   ├── config/
│   │   └── app.php             # Application config
│   ├── database/
│   │   └── migrations/         # Database migrations
│   ├── resources/
│   │   └── views/             # Template files
│   └── routes/
│       └── api.php            # API routes
└── vendor/                    # Composer dependencies

🛠️ CLI Commands

AvelPress includes a powerful CLI for rapid development:

# Create new plugin project
avel new vendor/plugin-name

# Make migration
avel make:migration create_users_table
avel make:migration add_email_to_users_table

# Make model
avel make:model User

# Generate basic controller
avel make:controller UserController
# Generate controller with CRUD methods
avel make:controller PostController --resource

# Build plugin
avel build
# Build plugin and ignore composer requirements
avel build --ignore-platform-reqs

📚 Documentation

• Official Documentation

📄 License

AvelPress is open-sourced software licensed under the MIT license.

🙏 Acknowledgments

• Inspired by Laravel framework
• Built for the WordPress ecosystem
• Thanks to all contributors

🔗 Links

• Documentation
• CLI Tool

Made with ❤️ for the WordPress community