PHPackages                             spiral/app-keeper - 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. spiral/app-keeper

ActiveProject[Framework](/categories/framework)

spiral/app-keeper
=================

Spiral Skeleton Application - Keeper

v0.8.1(1y ago)491.0k8[2 issues](https://github.com/spiral/app-keeper/issues)[3 PRs](https://github.com/spiral/app-keeper/pulls)MITHackPHP &gt;=8.1

Since May 8Pushed 1y ago8 watchersCompare

[ Source](https://github.com/spiral/app-keeper)[ Packagist](https://packagist.org/packages/spiral/app-keeper)[ Docs](https://spiral.dev)[ GitHub Sponsors](https://github.com/sponsors/spiral)[ RSS](/packages/spiral-app-keeper/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (16)Versions (19)Used By (0)

[![Spiral Framework](https://user-images.githubusercontent.com/2461257/112313394-d926c580-8cb8-11eb-84ea-717df4e4d167.png)](https://user-images.githubusercontent.com/2461257/112313394-d926c580-8cb8-11eb-84ea-717df4e4d167.png)

Rapid Admin Panel Application Skeleton [![Latest Stable Version](https://camo.githubusercontent.com/99a317f6fe0cdc06f1815562ecbcc91c6b1bded79996f7362c6d49180cf2183f/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f6170702d6b65657065722f76657273696f6e)](https://packagist.org/packages/spiral/app-keeper)
=========================================================================================================================================================================================================================================================================================================================

[](#rapid-admin-panel-application-skeleton-)

Spiral Framework is a High-Performance PHP/Go Full-Stack framework and group of over sixty PSR-compatible components. The Framework execution model based on a hybrid runtime where some services (GRPC, Queue, WebSockets, etc.) handled by Application Server [RoadRunner](https://github.com/spiral/roadrunner) and the PHP code of your application stays in memory permanently (anti-memory leak tools included).

[App Skeleton](https://github.com/spiral/app) ([CLI](https://github.com/spiral/app-cli), [GRPC](https://github.com/spiral/app-grpc)) | [**Documentation**](https://spiral.dev/docs) | [Twitter](https://twitter.com/spiralphp) | [CHANGELOG](/CHANGELOG.md) | [Contributing](https://github.com/spiral/guide/blob/master/contributing.md)

Server Requirements
-------------------

[](#server-requirements)

Make sure that your server is configured with following PHP version and extensions:

- PHP 8.1+, 64bit
- *mb-string* extension
- PDO Extension with desired database drivers (default SQLite)
- For FrontEnd build yarn and nodejs are required.

Application Bundle
------------------

[](#application-bundle)

Application bundle includes the following components:

- High-performance HTTP, HTTP/2 server based on [RoadRunner](https://roadrunner.dev)
- Console commands via Symfony/Console
- Translation support by Symfony/Translation
- Queue support for AMQP, Beanstalk, Amazon SQS, in-Memory
- Stempler template engine
- Security, validation, filter models
- PSR-7 HTTP pipeline, session, encrypted cookies
- DBAL and migrations support
- Monolog, Dotenv
- Prometheus metrics
- [Cycle DataMapper ORM](https://github.com/cycle)
- Keeper Admin panel

Demo Screenshot
---------------

[](#demo-screenshot)

[![Keeper Demo](https://user-images.githubusercontent.com/796136/81418518-79353800-9155-11ea-8266-e19fb2cce45a.png)](https://user-images.githubusercontent.com/796136/81418518-79353800-9155-11ea-8266-e19fb2cce45a.png)

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

[](#installation)

```
composer create-project spiral/app-keeper
cd app-keeper
yarn && yarn build

```

> **Note**Application server will be downloaded automatically (`php-curl` and `php-zip` required).

Once the application is installed you can ensure that it was configured properly by executing:

```
php app.php configure -vv

```

Migrate the database:

```
php app.php migrate:init
php app.php migrate

```

Seed user accounts:

```
php app.php user:seed

```

Create super admin account:

```
php app.php user:create {First-Name} {Last-Name} {email-address} {password}

```

To start application server execute:

```
./rr serve -d

```

On Windows:

```
./rr.exe serve -d

```

Application will be available on `http://localhost:8080`. Keeper control panel available at `http://localhost:8080/keeper`.

> **Note**Read more about application server configuration [here](https://roadrunner.dev/docs). Make sure to turn `DEBUG` off in `.env` to enable view caching.

Testing:
--------

[](#testing)

To test an application:

```
./vendor/bin/phpunit
```

Cloning:
--------

[](#cloning)

Make sure to properly configure project if you cloned the existing repository.

```
copy .env.sample .env
composer install
php app.php encrypt:key -m .env
php app.php configure -vv
php app.php migrate:init
php app.php migrate
./vendor/bin/rr get
yarn build
```

> **Note**Make sure to create super-admin account.

Docker:
-------

[](#docker)

Requirements: Docker engine 19.03.0+

To launch Keeper in Docker create env file if needed.

```
copy .env.sample .env
```

Build and run for Linux and MacOS

```
./dockerInit.sh
```

Build and run for Windows

```
./dockerInit.bat

```

It will build a local container, configure encryption key and set up Sqlite database.

Docker scenarios
----------------

[](#docker-scenarios)

In this repository you can find several docker-compose files, you can use them in combination to handle different scenarios.

You can launch Spiral application with Roadrunner in one container and frontend build with Nginx in another (it will serve static files and proxy dynamic requests to application container). No file sync, no worker reload: will work with the code version you have on the moment of container build on

```
docker-compose -f docker-compose.yml up -d

```

Or just

```
docker-compose up -d

```

Docker local development
------------------------

[](#docker-local-development)

For local development you would like file changes to appear in a container, and make Roadrunner workers to re-launch with updated code.

```
docker-compose -f docker-compose.yml -f docker-compose-local.yml up -d

```

Make sure you have vendor directory copied on host machine in this case, otherwise you'll mount code without vendor and autoload into a container and it will not work. You can do it like this:

```
docker-compose up -d
docker cp keeper:/var/www/vendor .
docker-compose -f docker-compose.yml -f docker-compose-local.yml up -d

```

Custom Frontend Build
---------------------

[](#custom-frontend-build)

For local development add one more docker compose file to sync local files into Nginx container:

```
docker-compose -f docker-compose.yml -f docker-compose-custom-front-local.yml up  -d

```

In this case you will need to run `yarn build` locally to create frontend build, otherwise empty directory public/generated will be mounted in nginx container

Frontend local development is supported in 2 modes:

**1. Watch mode.**

Launch `yarn watch` to watch `./front` directory for changes and recompile them on go. Refresh page to see changes.

**2. Hot reload mode.**

Set up env variable `FRONT_END_PUBLIC_URL` to point at local server URL, this package is configured to use `http://localhost:3030` Change scripts in `webpack` and `server` folders to change that.

After that launch `yarn start`. This will start dev server at `http://localhost:3030`

If you are seeing 404 on your scripts, ensure they are included like so

```
    @if(env('FRONT_END_PUBLIC_URL'))

    @endif
    @if(!env('FRONT_END_PUBLIC_URL'))

    @endif
```

Local development for both frontend and backend
-----------------------------------------------

[](#local-development-for-both-frontend-and-backend)

To enable all file sync you'll need all docker-compose files at once:

```
docker-compose -f docker-compose.yml -f docker-compose-local.yml -f docker-compose-custom-front-local.yml up  -d

```

License:
--------

[](#license)

MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information. Maintained by [Spiral Scout](https://spiralscout.com).

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance47

Moderate activity, may be stable

Popularity28

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

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 ~232 days

Recently: every ~418 days

Total

9

Last Release

385d ago

PHP version history (2 changes)v0.5aPHP &gt;=7.2

v0.8.0PHP &gt;=8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/796136?v=4)[Anton Tsitou](/maintainers/wolfy-j)[@wolfy-j](https://github.com/wolfy-j)

---

Top Contributors

[![AndrewKirkovski](https://avatars.githubusercontent.com/u/16134699?v=4)](https://github.com/AndrewKirkovski "AndrewKirkovski (53 commits)")[![SerafimArts](https://avatars.githubusercontent.com/u/2461257?v=4)](https://github.com/SerafimArts "SerafimArts (21 commits)")[![wolfy-j](https://avatars.githubusercontent.com/u/796136?v=4)](https://github.com/wolfy-j "wolfy-j (20 commits)")[![butschster](https://avatars.githubusercontent.com/u/773481?v=4)](https://github.com/butschster "butschster (20 commits)")[![msmakouz](https://avatars.githubusercontent.com/u/67324318?v=4)](https://github.com/msmakouz "msmakouz (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![EvgenyBarinov](https://avatars.githubusercontent.com/u/65846823?v=4)](https://github.com/EvgenyBarinov "EvgenyBarinov (3 commits)")[![anlamas](https://avatars.githubusercontent.com/u/31503975?v=4)](https://github.com/anlamas "anlamas (2 commits)")[![roxblnfk](https://avatars.githubusercontent.com/u/4152481?v=4)](https://github.com/roxblnfk "roxblnfk (2 commits)")[![vvval](https://avatars.githubusercontent.com/u/11367763?v=4)](https://github.com/vvval "vvval (2 commits)")[![hitmouz](https://avatars.githubusercontent.com/u/95587607?v=4)](https://github.com/hitmouz "hitmouz (1 commits)")[![alexndr-novikov](https://avatars.githubusercontent.com/u/7372962?v=4)](https://github.com/alexndr-novikov "alexndr-novikov (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

keeperphpspiral

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/spiral-app-keeper/health.svg)

```
[![Health](https://phpackages.com/badges/spiral-app-keeper/health.svg)](https://phpackages.com/packages/spiral-app-keeper)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M736](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M203](/packages/sulu-sulu)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k16.4k79](/packages/elgg-elgg)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)[laravel/nova-devtool

Devtool for Laravel Nova Development

33625.5k189](/packages/laravel-nova-devtool)

PHPackages © 2026

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