PHPackages                             kuick/project - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. kuick/project

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

kuick/project
=============

v2.8.4.1(1mo ago)1718PHPCI passing

Since Jan 24Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/milejko/kuick-project)[ Packagist](https://packagist.org/packages/kuick/project)[ RSS](/packages/kuick-project/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (8)Versions (17)Used By (0)

Kuick Project
=============

[](#kuick-project)

[![Latest Version](https://camo.githubusercontent.com/5e32b3ea1551affdde045539beb5fddcf3e6bab9106834170b4738e449d68ae3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6d696c656a6b6f2f6b7569636b2d70726f6a6563742e7376673f63616368655365636f6e64733d3134343030)](https://github.com/milejko/kuick-project/releases)[![PHP](https://camo.githubusercontent.com/e0cd02cfaa76baa1c8674463a1c40439faeae7d753a51a853d239a15a35bdda8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e33253230253743253230382e34253230253743253230382e352d626c75653f6c6f676f3d7068702663616368655365636f6e64733d33363030)](https://www.php.net)[![Total Downloads](https://camo.githubusercontent.com/4c2701cfc6ad6c375d5cadcfbfe1e28472d025dab8fc528914ce34bcf7208e55/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b7569636b2f70726f6a6563742e7376673f63616368655365636f6e64733d3134343030)](https://packagist.org/packages/kuick/project)[![CI](https://github.com/milejko/kuick-project/actions/workflows/ci.yml/badge.svg)](https://github.com/milejko/kuick-project/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/1bf5da4adfd6e825a4ccc79c50029d563e5f1ceb736a89d5bf2b87eef0f18e7e/68747470733a2f2f636f6465636f762e696f2f67682f6d696c656a6b6f2f6b7569636b2d70726f6a6563742f67726170682f62616467652e7376673f746f6b656e3d38305145424448475048)](https://codecov.io/gh/milejko/kuick-project)[![Software License](https://camo.githubusercontent.com/e2f0982d826e942af97a6e879597c2301c2a8a97567d69e47148db858bbc5de3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f63616368655365636f6e64733d3134343030)](LICENSE)

A skeleton application built on top of [Kuick Framework](https://github.com/milejko/kuick-framework) — get a working PHP app with routing, console commands, DI, and Docker support in minutes.

Features
--------

[](#features)

- 📦 Ready-to-use project structure with sample controllers and console commands
- 🐳 Dockerfile with `dev-server`, `test`, and production targets
- 🔒 Guard-based security (e.g. bearer token for `/api/ops`)
- 🧪 PHPUnit, PHPStan (level 9), PHPMD, and PSR-12 checks out of the box

Quick Start
-----------

[](#quick-start)

### Option A — Composer create-project

[](#option-a--composer-create-project)

```
composer create-project kuick/project my-app
cd my-app
```

### Option B — Clone the repository

[](#option-b--clone-the-repository)

```
git clone https://github.com/milejko/kuick-project.git my-app
cd my-app
```

### Start the dev server (Docker + Make)

[](#start-the-dev-server-docker--make)

```
make up
```

The app will be available at ****. Source code is mounted as a volume, so changes are reflected immediately — no rebuild needed.

> **Manual Docker equivalent:**
>
> ```
> docker build --target=dev-server --tag=kuick-project .
> docker run --rm --name kuick-project -v ./:/var/www/html kuick-project composer install
> docker run --rm --name kuick-project -v ./:/var/www/html -p 8080:80 -e APP_ENV=dev kuick-project
> ```

Sample Routes
-------------

[](#sample-routes)

MethodPathDescriptionGET`/`Homepage (Hello World)GET`/hello/{name}`Greeting with nameGET, POST`/ping`Ping endpointGET`/api/ops`OPS/health info (requires bearer token in prod)```
curl http://localhost:8080/
curl http://localhost:8080/hello/John
curl http://localhost:8080/ping
```

Docker Demo (pre-built image)
-----------------------------

[](#docker-demo-pre-built-image)

Pull and run the ready-to-go image from [Docker Hub](https://hub.docker.com/r/kuickphp/kuick/tags):

```
docker run -p 8080:80 kuickphp/kuick
```

### Runtime configuration via environment variables

[](#runtime-configuration-via-environment-variables)

```
docker run -p 8080:80 \
    -e APP_ENV=dev \
    -e APP_NAME=ExampleApp \
    -e APP_CHARSET=UTF-8 \
    -e APP_LOCALE=pl_PL.utf-8 \
    -e APP_TIMEZONE="Europe/Warsaw" \
    -e APP_LOG_USEMICROSECONDS=1 \
    -e APP_LOG_LEVEL=DEBUG \
    -e API_SECURITY_OPS_GUARD_TOKEN=secret-token \
    kuickphp/kuick:alpine
```

With `API_SECURITY_OPS_GUARD_TOKEN` set, you can access the OPS endpoint:

```
curl -H "Authorization: Bearer secret-token" http://localhost:8080/api/ops
```

Development &amp; Testing
-------------------------

[](#development--testing)

```
composer test:all      # run all checks (PSR-12, PHPStan, PHPMD, PHPUnit)
composer test:phpcs    # PSR-12 code style
composer test:phpstan  # static analysis (level 9)
composer test:phpmd    # mess detector
composer test:phpunit  # unit tests with coverage
composer fix:phpcbf    # auto-fix code style issues

make test              # run the full CI suite inside Docker
```

License
-------

[](#license)

[MIT](LICENSE)

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance90

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~31 days

Recently: every ~16 days

Total

16

Last Release

51d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f986340afe26a382bdec4d838f514714b6f5bc7222baf73972001a66b9b6dab0?d=identicon)[emisarius](/maintainers/emisarius)

---

Top Contributors

[![milejko](https://avatars.githubusercontent.com/u/14335568?v=4)](https://github.com/milejko "milejko (36 commits)")

### Embed Badge

![Health badge](/badges/kuick-project/health.svg)

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

###  Alternatives

[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.2k](/packages/friendsofphp-php-cs-fixer)[pnlinh/laravel-google-distance

Caculate Google Distance Matrix API in Laravel

1657.7k](/packages/pnlinh-laravel-google-distance)[redsquirrelstudio/laravel-backpack-import-operation

An operation to make configurable imports for your CRUDs using the Backpack api you know and love

1914.3k](/packages/redsquirrelstudio-laravel-backpack-import-operation)[japanese-date/japanese-date

日本の暦、祝日を取り扱うライブラリ

1610.0k](/packages/japanese-date-japanese-date)[james.xue/laravel-admin-breadcrumb

Breadcrumb Sinicization

171.7k](/packages/jamesxue-laravel-admin-breadcrumb)

PHPackages © 2026

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