README

Prism Init scaffolds a complete, convention-following backend API from your existing database in one command.

What gets generated per table

Plus, once:

Conventions followed

Database (3.3.1)

• Table names: snake_case, plural (employees, salary_grades)
• Model names: PascalCase, singular (Employee)
• Soft deletes: deleted_at on every model (configurable)
• Timestamps: created_at, updated_at on every model

PHP / Laravel (3.3.2)

• Models: PascalCase singular, $fillable, $casts, SoftDeletes — columns auto-populated from DB
• Controllers: thin — validate → delegate to Service → return Resource
• Services: all business logic inside DB::transaction() where needed, list() returns paginated results
• Requests: Store{Model}Request / Update{Model}Request — validation rules inferred from DB column types
• Resources: {Model}Resource — all fields auto-populated from DB columns
• Policies: {Model}Policy with all standard gates stubbed
• Response envelope: consistent { success, data, message, errors } via ApiResponse trait

Requirements

Installation

composer require innonazarene/prism-init --dev

Publish the config if you want to customise defaults:

php artisan vendor:publish --tag=prism-init-config

Publish stubs to customise them (optional):

php artisan vendor:publish --tag=prism-init-stubs
# → published to stubs/prism-init/

Usage

php artisan prism:init

Options

Examples

# Full scaffold, version prefix v2
php artisan prism:init --prefix=v2

# Only two tables, flat structure
php artisan prism:init --tables=orders,products --flat

# Skip migrations and seeds (DB already set up)
php artisan prism:init --skip-migrate --skip-seed

# No soft deletes, no policies
php artisan prism:init --no-soft-deletes --skip-policies

Generated output example

Given a departments table, Prism Init produces:

app/Models/Department/Department.php

class Department extends Model
{
    use SoftDeletes;

    protected $table = 'departments';

    protected $fillable = [
        'name',
        'code',
        'description',
    ];

    protected $casts = [
        'deleted_at' => 'datetime',
    ];
}

app/Services/Department/DepartmentService.php

public function list(array $filters = []): LengthAwarePaginator
{
    $perPage = isset($filters['per_page']) ? (int) $filters['per_page'] : 15;

    return Department::query()
        ->latest()
        ->paginate($perPage);
}

app/Http/Controllers/Api/V1/Department/DepartmentController.php

class DepartmentController extends Controller
{
    use ApiResponse;

    public function __construct(
        private readonly DepartmentService $service
    ) {}

    public function index(Request $request): JsonResponse
    {
        $data = $this->service->list($request->all());
        return $this->successResponse(DepartmentResource::collection($data), 'Department list retrieved.');
    }

    // store / show / update / destroy …
}

app/Http/Requests/Department/StoreDepartmentRequest.php

public function rules(): array
{
    return [
        'name'        => 'required|string|max:255',
        'code'        => 'required|string|max:50',
        'description' => 'sometimes|nullable|string',
    ];
}

app/Http/Resources/Department/DepartmentResource.php

public function toArray(Request $request): array
{
    return [
        'id'          => $this->id,
        'name'        => $this->name,
        'code'        => $this->code,
        'description' => $this->description,
        'created_at'  => $this->created_at,
        'updated_at'  => $this->updated_at,
    ];
}

app/Traits/ApiResponse.php — envelope methods:

// Success:   { success: true,  data: T,    message: string, errors: null }
// Error:     { success: false, data: null, message: string, errors: object }
// Paginated: { success: true,  data: T[],  meta: { current_page, last_page, per_page, total }, … }

routes/api.php

use App\Http\Controllers\Api\V1\Department\DepartmentController;

Route::prefix('v1')->group(function () {
    Route::apiResource('departments', DepartmentController::class);
});

Customising stubs

After publishing stubs (--tag=prism-init-stubs), edit any file in stubs/prism-init/. Prism Init always prefers your published stub over the package default.

Available stubs:

Optional Packages

Prism Init detects these packages at runtime. If installed, they are used automatically — if not, the step is skipped with an install hint.

Backup & re-running

On every run, Prism saves clean copies of routes/api.php and Controller.php to public/backup/ and restores them before regenerating — so you always start from a clean slate.

Contributing

Pull requests welcome. Please open an issue first to discuss changes.

git checkout -b feat/my-feature
# … make changes …
vendor/bin/phpunit
git push && open PR

License

MIT — see LICENSE.