PHPackages                             bkwld/decoy - 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. [Database &amp; ORM](/categories/database)
4. /
5. bkwld/decoy

ActiveLibrary[Database &amp; ORM](/categories/database)

bkwld/decoy
===========

A Laravel model-based CMS by Bukwild

5.11.1(4y ago)3023.2k42[22 issues](https://github.com/BKWLD/decoy/issues)MITPHPPHP &gt;=5.4.0

Since Aug 22Pushed 2y ago23 watchersCompare

[ Source](https://github.com/BKWLD/decoy)[ Packagist](https://packagist.org/packages/bkwld/decoy)[ RSS](/packages/bkwld-decoy/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (28)Versions (101)Used By (0)

Decoy [![Build Status](https://camo.githubusercontent.com/33454e9d9353b5e2d40e41b9f68ea2ea870fe09a2103d31d4668d4a6a92e88a2/68747470733a2f2f7472617669732d63692e6f72672f424b574c442f6465636f792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/BKWLD/decoy) [![Coverage Status](https://camo.githubusercontent.com/2cf34190cc03ad24587b217e1a65cdfeb3b74497f69d82a24629f66419b034a5/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f424b574c442f6465636f792f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/BKWLD/decoy?branch=master)
==================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#decoy--)

Decoy is a PHP content management written for the [Laravel framework](https://laravel.com) that allows you to access your data using standard Laravel [Eloquent](https://laravel.com/docs/eloquent) models.

- Quick Start:
- Documentation:
- Case study:
- Announcement article:

Screenshots
-----------

[](#screenshots)

[![Screenshot of example projects listing](https://camo.githubusercontent.com/d7c5ae1f5d59bfdd5d8014f6c0d930e086303f12f2a835775d92f8ad1c51ddbc/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f70726f6a656374732e6a7067)](https://camo.githubusercontent.com/d7c5ae1f5d59bfdd5d8014f6c0d930e086303f12f2a835775d92f8ad1c51ddbc/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f70726f6a656374732e6a7067)[![Screenshot of example project edit view](https://camo.githubusercontent.com/8e391350062ccd553d4d8265747640ed39ae79b8ffd348d0996eeaa15e2620a7/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f70726f6a6563742e6a7067)](https://camo.githubusercontent.com/8e391350062ccd553d4d8265747640ed39ae79b8ffd348d0996eeaa15e2620a7/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f70726f6a6563742e6a7067)[![Screenshot of example category edit view](https://camo.githubusercontent.com/be8ad3d74d4e75c721c4927865d0befef069faa0c8c3336b36e2cbc42bd231a3/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f63617465676f72792e6a7067)](https://camo.githubusercontent.com/be8ad3d74d4e75c721c4927865d0befef069faa0c8c3336b36e2cbc42bd231a3/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f63617465676f72792e6a7067)[![Screenshot of elements editor](https://camo.githubusercontent.com/79e02d001bbe4de240761641c96b80b40bd362cddecc23e0f8ba0fbd92a6f47a/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f656c656d656e74732e6a7067)](https://camo.githubusercontent.com/79e02d001bbe4de240761641c96b80b40bd362cddecc23e0f8ba0fbd92a6f47a/687474703a2f2f646f63732e6465636f792e62756b77696c642e636f6d2f6173736574732f696d672f726561646d652f656c656d656e74732e6a7067)

About
-----

[](#about)

Since 2012 and Laravel 3, [Bukwild](http://www.bukwild.com) has been maintaining our own content management system that we call [Decoy](http://www.bukwild.com/project/decoy). Decoy is meant to reduce the development effort for implementing content management while being highly flexible. And it helps you generate a great looking, easy to use admin interface; no manual required.

The driving philosophy behind Decoy is that a CMS should share models with your public facing app; your app interacts with data stored with Decoy only through standard Laravel models. This approach makes reading controller code simple (`Article::ordered()->take(6)->get()`), gives you access to Laravel mutators so you views are human readable (`$article->full_date`), and allows you to share business logic between admin and public sites. There is no additional templating or querying language to learn. After the CMS is setup, the developer interacts with the data using purely Laravel APIs.

Features
--------

[](#features)

Besides it’s model-centric paradigm, Decoy includes the following features:

- Great looking, zero-training required design
- [Croppa](https://github.com/BKWLD/croppa) integration for advanced image support including cropping, setting focal point, and storing alt text
- Video encoding via [Zencoder](https://zencoder.com/) integration
- WYSIWYG text editing via [Redactor](https://imperavi.com/redactor/)
- Support for all Laravel relationship types
- Easy creation of content editing forms using [Former](http://formers.github.io/former/)
- Remote file storage (S3, etc) via [Upchuck](https://github.com/BKWLD/upchuck) and [Flysystem](http://flysystem.thephpleague.com/)
- Granular admin permissioning
- Fully customizable edit views with [Bootstrap](http://getbootstrap.com/) support
- Commands panel for executing artisan commands via web UI
- Cloning of content, even across servers
- Localization
- Organized key-value pair type data as [Elements](http://docs.decoy.bukwild.com/elements)
- Drag and drop ordering of data in list views
- Built in interface for creating 301 and 302 redirects
- All configuration stored in the filesystem to keep your team in sync via Git (or whatever VCS)

Implementation
--------------

[](#implementation)

Decoy installs into your app as a composer package and integrates with your project rather than being a standalone install. Decoy shares the Eloquent models of your public site and stores data in regular Laravel migrated tables. Your controllers and views do not need to touch Decoy at all and while your models need to use Decoy’s subclass of `Eloquent\Model`, there is very little behavior added at model instantiation. In other words, Decoy adds almost no overhead to your public site.

Implementing Decoy to manage model is done through a common MVC pattern that allows for overriding of default behavior at every step:

- The admin nav, permission levels, localization options, and other settings are stored in Laravel-style php config arrays
- For each manageable database table / Eloquent model, a Laravel-style controller is created that allows you to override defaults like how the title of the model appears, it’s description, how it can be searched within the admin, and even override any CRUD method (create, update, destroy, etc).
- You specify validation rules, ordering scopes, and features like which relationships to follow when cloning from the model, adding specifically named properties and methods.
- Finally, you create a regular Laravel view containing the form that should be shown to the admin during creation and editing of content. This is easier than it sounds through support of Former and many Decoy-unqiue Former fields like our image uploader and wysiwyg types.

Next steps
----------

[](#next-steps)

Interested in giving Decoy a spin? Check out the [quick start guide](http://docs.decoy.bukwild.com/quick-start).

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 88.5% 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 ~349 days

Total

99

Last Release

1613d ago

Major Versions

3.5.3 → 4.0.22014-11-11

3.4.12 → 4.2.02014-12-01

4.11.1 → 5.0.02016-05-11

4.8.5 → 5.1.02016-11-09

4.x-dev → 5.11.12021-12-08

PHP version history (2 changes)2.0.0PHP &gt;=5.3.0

4.11.0PHP &gt;=5.4.0

### Community

Maintainers

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

---

Top Contributors

[![weotch](https://avatars.githubusercontent.com/u/77567?v=4)](https://github.com/weotch "weotch (2777 commits)")[![brokenhd](https://avatars.githubusercontent.com/u/2153609?v=4)](https://github.com/brokenhd "brokenhd (210 commits)")[![mattaebersold](https://avatars.githubusercontent.com/u/435606?v=4)](https://github.com/mattaebersold "mattaebersold (71 commits)")[![aaron-nunley](https://avatars.githubusercontent.com/u/661163?v=4)](https://github.com/aaron-nunley "aaron-nunley (24 commits)")[![svenluijten](https://avatars.githubusercontent.com/u/11269635?v=4)](https://github.com/svenluijten "svenluijten (20 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (18 commits)")[![thelucre](https://avatars.githubusercontent.com/u/4340866?v=4)](https://github.com/thelucre "thelucre (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![arminulrich](https://avatars.githubusercontent.com/u/632486?v=4)](https://github.com/arminulrich "arminulrich (1 commits)")[![kulemantu](https://avatars.githubusercontent.com/u/907164?v=4)](https://github.com/kulemantu "kulemantu (1 commits)")[![noxify](https://avatars.githubusercontent.com/u/521777?v=4)](https://github.com/noxify "noxify (1 commits)")[![seanthepottingshed](https://avatars.githubusercontent.com/u/12046965?v=4)](https://github.com/seanthepottingshed "seanthepottingshed (1 commits)")

---

Tags

cmseloquentlaravel

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bkwld-decoy/health.svg)

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

###  Alternatives

[laravel-doctrine/orm

An integration library for Laravel and Doctrine ORM

8425.3M87](/packages/laravel-doctrine-orm)[tucker-eric/eloquentfilter

An Eloquent way to filter Eloquent Models

1.8k4.8M26](/packages/tucker-eric-eloquentfilter)[ryangjchandler/orbit

A flat-file database driver for Eloquent.

922256.2k5](/packages/ryangjchandler-orbit)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

423715.4k1](/packages/clickbar-laravel-magellan)

PHPackages © 2026

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