PHPackages                             devinci-it/blprnt - 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. devinci-it/blprnt

ActiveComposer-plugin

devinci-it/blprnt
=================

A minimal, extensible PHP micro-framework (Blueprint for modern apps)

1.0.0(yesterday)02↓100%MITPHP

Since Apr 6Pushed todayCompare

[ Source](https://github.com/devinci-it/devinci-it-blprnt)[ Packagist](https://packagist.org/packages/devinci-it/blprnt)[ RSS](/packages/devinci-it-blprnt/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (2)Used By (0)

Blprnt
======

[](#blprnt)

[![blprnt-logo](resources/logo-l.svg)](resources/logo-l.svg)

Blprnt is a minimal, extensible PHP micro-framework

Philosophy
----------

[](#philosophy)

> Blueprint your app, do not over-engineer it.

- Convention over configuration (while staying configurable)
- Clear MVC boundaries
- Lightweight core with explicit flow
- Middleware-first HTTP pipeline
- Practical developer experience without hidden magic

Core Features
-------------

[](#core-features)

- Minimal application kernel and request lifecycle
- PSR-4 autoloading
- Router with middleware support
- Simple controller and view foundation
- Environment-aware error handling
- CLI command registry and command kernel
- SCSS build support via bundled style commands

Requirements
------------

[](#requirements)

- PHP 8.1+
- Composer 2+

Installation
------------

[](#installation)

1. Allow the Composer plugin:

    ```
    composer config --no-plugins allow-plugins.devinci-it/blprnt true
    ```
2. Require the package:

    ```
    composer require devinci-it/blprnt
    ```

Bootstrap Publishing Flow
-------------------------

[](#bootstrap-publishing-flow)

On package install/update, Blprnt publishes missing project scaffolding and starter assets.

### Published directories

[](#published-directories)

- `app`
- `bootstrap`
- `routes`
- `config`

### Published files

[](#published-files)

- `.env`
- `blprnt`
- `public/index.php`

### Resource-driven setup

[](#resource-driven-setup)

- `resources/views` -&gt; `app/Views`
- `resources/scss` -&gt; `resources/scss` (project-local editable SCSS)
- `resources/logo.svg` -&gt; `public/logo.svg`
- `resources/favicon.svg` -&gt; `public/favicon.svg`

### Automatic style build

[](#automatic-style-build)

During publishing, Blprnt compiles SCSS from `resources/scss` into:

- `public/vendor/devinci-it/blprnt/css`

This keeps generated CSS in `public` while preserving source files in `resources`.

Style Commands
--------------

[](#style-commands)

Use the CLI script to compile styles manually:

```
./blprnt build:styles --source=resources/scss --output=public/vendor/devinci-it/blprnt/css --style=compressed --force
```

Common options:

- `--source`: source SCSS directory
- `--output`: output CSS directory
- `--style`: `compressed` or `expanded`
- `--force`: overwrite existing CSS files
- `--clean`: remove output directory before compiling

Project Layout
--------------

[](#project-layout)

```
app/
  Controllers/
  Middleware/
  Views/
bootstrap/
config/
public/
resources/
  scss/
  views/
routes/
src/

```

PHP File Documentation
----------------------

[](#php-file-documentation)

This section documents key PHP components and responsibility boundaries.

### Composer integration

[](#composer-integration)

- `src/Composer/BlprntPlugin.php`

    - Composer plugin entry point.
    - Subscribes to package install/update events.
    - Triggers publish flow when Blprnt is installed or updated.
- `src/Composer/Installer.php`

    - Publishes skeleton directories and bootstrap files.
    - Seeds project `app/Views` and `public` assets from `resources`.
    - Invokes style compilation into public CSS output.

### Console subsystem

[](#console-subsystem)

- `src/Console/Kernel.php`

    - Dispatches command signatures to registered command instances.
- `src/Console/CommandRegistry.php`

    - Central registry for command class instances.
- `src/Console/Command.php`

    - Base command abstraction with option parsing and handler support.
- `src/Console/Commands/Styles/BuildStylesCommand.php`

    - Recursively compiles SCSS files into CSS output structure.
- `src/Console/Commands/Styles/ScssCompileCommand.php`

    - Compiles a single SCSS entry file to one CSS output.

### HTTP and MVC core

[](#http-and-mvc-core)

- `src/Core/App.php` and `src/Http/Kernel.php`

    - Application bootstrap and request handling integration.
- `src/Core/Router.php`

    - Route registration and dispatch.
- `src/Core/Pipeline.php`

    - Middleware pipeline execution.
- `src/Core/Controller.php` and `src/Core/View.php`

    - Base controller helpers and view rendering.
- `src/Core/ErrorHandler.php`

    - Development/production error reporting strategy.

License
-------

[](#license)

MIT

###  Health Score

36

—

LowBetter than 81% of packages

Maintenance100

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4d3d3b0aec4f30cd6bca90b49a9c4bb801be47143d3e7fac6ab06ec6e6f589f?d=identicon)[devinci-it](/maintainers/devinci-it)

### Embed Badge

![Health badge](/badges/devinci-it-blprnt/health.svg)

```
[![Health](https://phpackages.com/badges/devinci-it-blprnt/health.svg)](https://phpackages.com/packages/devinci-it-blprnt)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)[doppar/framework

The Doppar Framework

366.7k8](/packages/doppar-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
