PHPackages                             memran/marwa-php - 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. memran/marwa-php

ActiveProject[Framework](/categories/framework)

memran/marwa-php
================

MarwaPHP - a polished starter scaffold for the Marwa framework

v1.0.5(1mo ago)57MITPHPPHP >=8.2CI failing

Since Apr 19Pushed 2w agoCompare

[ Source](https://github.com/memran/marwa-php)[ Packagist](https://packagist.org/packages/memran/marwa-php)[ RSS](/packages/memran-marwa-php/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (5)Versions (7)Used By (0)

MarwaPHP — AI Native PHP Framework
==================================

[](#marwaphp--ai-native-php-framework)

 [![Composer](https://camo.githubusercontent.com/433965703c136c3fbd455da29776674157b01d7ab0e3e9a00b949887efe753f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d656d72616e2f6d617277612d7068703f6c6162656c3d636f6d706f736572267374796c653d666c6174)](https://camo.githubusercontent.com/433965703c136c3fbd455da29776674157b01d7ab0e3e9a00b949887efe753f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d656d72616e2f6d617277612d7068703f6c6162656c3d636f6d706f736572267374796c653d666c6174) [![PHP](https://camo.githubusercontent.com/411c4977d9447411be2d736e5c1f79184145fde70fedcfca0cec9e06c8e8096f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d656d72616e2f6d617277612d7068702f7068703f6c6162656c3d504850267374796c653d666c6174)](https://camo.githubusercontent.com/411c4977d9447411be2d736e5c1f79184145fde70fedcfca0cec9e06c8e8096f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d656d72616e2f6d617277612d7068702f7068703f6c6162656c3d504850267374796c653d666c6174) [![PHPUnit](https://camo.githubusercontent.com/c36676fb543945b3ba041af8c29788966f31b2f65714201df9dd5f5cd31a5d6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d656d72616e2f6d617277612d7068702f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d504850556e6974267374796c653d666c6174)](https://camo.githubusercontent.com/c36676fb543945b3ba041af8c29788966f31b2f65714201df9dd5f5cd31a5d6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d656d72616e2f6d617277612d7068702f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d504850556e6974267374796c653d666c6174) [![PHPStan](https://camo.githubusercontent.com/035299f76fa1e2021f702ee007fab35e11b7f93157ce2f04f84f50316a7fb1f3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d656d72616e2f6d617277612d7068702f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d5048505374616e267374796c653d666c6174)](https://camo.githubusercontent.com/035299f76fa1e2021f702ee007fab35e11b7f93157ce2f04f84f50316a7fb1f3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d656d72616e2f6d617277612d7068702f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d5048505374616e267374796c653d666c6174)

**Build intelligent applications with the first PHP framework designed for the AI era.**

MarwaPHP is an AI-native framework that brings smart automation to modern PHP development. From AI-powered code generation to intelligent task scheduling and built-in agent support — MarwaPHP is built to work seamlessly with AI tools and workflows.

> **Zero-boilerplate. Maximum intelligence. Pure PHP.**

---

AI-Native Features
------------------

[](#ai-native-features)

FeatureDescription**AI Code Generation**Let AI generate controllers, models, and migrations with built-in scaffolding**Smart Task Scheduling**AI-assisted cron expressions and natural language scheduling**Intelligent Queue**Auto-scaling job processing with AI-driven worker management**Built-in Agent Support**First-class support for AI agents to interact with your application**Activity Logging**Track AI interactions and system events automatically---

1. Quick Start
--------------

[](#1-quick-start)

```
composer create-project memran/marwa-php my-app
cd my-app
php marwa migrate
php marwa module:migrate
php marwa module:seed
php -S localhost:8000 -t public/
```

Access at

---

2. Requirements
---------------

[](#2-requirements)

- PHP 8.2+ (optimized for AI workloads)
- Composer
- Node.js 20+ (for Tailwind CSS builds)
- SQLite (default) or MySQL/MariaDB

---

3. Running the Application
--------------------------

[](#3-running-the-application)

### Local Development

[](#local-development)

```
# Install dependencies
composer install
cp .env.example .env

# Setup database
php marwa migrate
php marwa module:migrate
php marwa module:seed

# Start local server
php -S localhost:8000 -t public/
```

### Frontend Assets

[](#frontend-assets)

```
# Install Node dependencies
npm install

# Development (with hot reload)
npm run dev

# Production build
npm run build

# Build admin theme only
npm run css:build:admin
```

### Common Commands

[](#common-commands)

CommandDescription`php -S localhost:8000 -t public/`Start local development server`php marwa migrate`Run framework migrations`php marwa module:migrate`Run module migrations`php marwa module:seed`Seed module data`php marwa queue:work --daemon`Start queue worker`php marwa schedule:run`Run scheduled tasks`php marwa db:check`Check database connection### Code Quality

[](#code-quality)

```
composer test       # Run PHPUnit
composer analyse    # Run PHPStan (level 6)
composer lint        # Check PHP syntax
composer ci          # Full validation chain
```

---

4. Project Structure
--------------------

[](#4-project-structure)

```
app/
├── Http/
│   ├── Controllers/    # Thin controllers
│   └── Middleware/     # App-specific middleware
├── Providers/          # Service providers
└── Commands/          # Console commands
modules/               # Feature modules
├── Auth/              # Authentication
├── Users/             # User management
├── Activity/          # Activity logging
├── Settings/          # Settings management
├── BackgroundJobs/   # Scheduler UI
├── Queue/             # Queue management
├── Dashboard/         # Admin dashboard
└── Notifications/     # Notification system
config/                # App configuration
resources/
├── views/
│   ├── components/    # Shared Twig components
│   └── themes/        # Theme views (default, admin)
└── css/               # Source stylesheets
routes/                # HTTP routes
database/
├── migrations/        # Shared migrations
└── sqlite/           # SQLite database
tests/                 # PHPUnit tests

```

---

5. Creating a New Module
------------------------

[](#5-creating-a-new-module)

Create a self-contained module following the `Users` module structure:

```
mkdir -p modules/Blog/{database/migrations,database/seeders,Http/Controllers,Models,resources/views,routes}
```

### Module Manifest

[](#module-manifest)

```