PHPackages                             colymba/silverstripe-project-boilerplate - 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. colymba/silverstripe-project-boilerplate

ActiveSilverstripe-module

colymba/silverstripe-project-boilerplate
========================================

SilverStripe Project boilerplate/skeleton with nifty tools, tips and tricks.

4142[2 PRs](https://github.com/colymba/silverstripe-project-boilerplate/pulls)JavaScript

Since Feb 17Pushed 10y ago1 watchersCompare

[ Source](https://github.com/colymba/silverstripe-project-boilerplate)[ Packagist](https://packagist.org/packages/colymba/silverstripe-project-boilerplate)[ RSS](/packages/colymba-silverstripe-project-boilerplate/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Silverstripe Project Boilerplate
================================

[](#silverstripe-project-boilerplate)

[![Latest Stable Version](https://camo.githubusercontent.com/acaf11ea5cd0f73c50e7b9a2cb08dc4f4124f48215fe4d9ba17d67eef509e8b1/68747470733a2f2f706f7365722e707567782e6f72672f636f6c796d62612f73696c7665727374726970652d70726f6a6563742d626f696c6572706c6174652f762f737461626c652e737667)](https://github.com/colymba/silverstripe-project-boilerplate/releases)[![Latest Unstable Version](https://camo.githubusercontent.com/fc3762ea4e4dada2e935b7a5bd4945a9049831350859a3a1dd56dcae99efd0f0/68747470733a2f2f706f7365722e707567782e6f72672f636f6c796d62612f73696c7665727374726970652d70726f6a6563742d626f696c6572706c6174652f762f756e737461626c652e737667)](https://github.com/colymba/silverstripe-project-boilerplate/tree/master)[![License](https://camo.githubusercontent.com/92acf25534732b3502e071bf09471f3d49c1fa9e2b42c6371e0fc4725341ff35/68747470733a2f2f706f7365722e707567782e6f72672f636f6c796d62612f73696c7665727374726970652d70726f6a6563742d626f696c6572706c6174652f6c6963656e73652e737667)](#license-bsd-simplified)

A very much opinionated SilverStripe project boilerplate/skeleton with nifty tools, tips and tricks.

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

[](#requirements)

- SilverStripe 3
- NodeJS
- GruntJS
- Bower

TL;DR
-----

[](#tldr)

This project replaces the default `mysite` and `themes` folders that comes with any SilverStipe install. And replaces those with a tightly packed project directory easy to manage and ship.

ActionTerminalInit dependencies`npm update`-`bower update`Start coding`grunt dev`Ready to ship`grunt dist`### In details

[](#in-details)

Once you have SilverStripe up and running, save your important `_config.php` settings and get rid of the `mysite` folder. Rename the `ss-project-boilerplate` folder to something that makes sense for you and update the `_config.php`.

There are comments in most of the files included, so read on to learn more about each specific lines. This module will *impose* the following project structure:

Folder/FileContent`_config`YAML config + includes for `_config.php``_config.php`Base config + include additional ones-------------------------------------------------------------------------------------`_dist`Ready to ship optimized project will be generated here-------------------------------------------------------------------------------------`code`All your code`code/controllers``Controllers``code/models`Everything `DataObjects``code/models/admins``ModelAdmins``code/models/dataObjects``DataObjects``code/models/extensions``DataExtensions``code/models/pages``SiteTree` descendants-------------------------------------------------------------------------------------`code/views`Everything front-end`code/views/css`SCSS`code/views/fonts`Fonts`code/views/img`Images`code/views/js`JS`code/views/js/vendor`Non Bower JS libraries`code/views/templates`SS templates#### Front-end dependencies

[](#front-end-dependencies)

All front-end dependencies (CSS + JS) are managed via Bower, edit the `bower.json` to suite your needs then run `bower update`. These will automatically be injected later on in the SileverStripe templates (`Page.ss` + `js.ss`).

#### Developing and publishing your project

[](#developing-and-publishing-your-project)

We'll be using GruntJS to automate the development and publishing process, so make sure to first have the NodeJS packages dependencies installed by runnning `npm update`.

Once that's done, run `grunt dev` and start coding. This will inject Bower JS/CSS/SCSS dependencies for you, create a customized Modernizr and watch and compile your SASS for you.

Once you are done and ready to publish your project, run `grunt dist` and an optimized copy of all your project files will be in the `_dist` directory ready to upload. Config will be updated to live, CSS/JS concatenated and minified, and all you templates minified too.

#### Dev/Live configurations

[](#devlive-configurations)

The `grunt dist` task will autiomatically replace references of `environment_type: 'dev'` to `live` in your `config.yml`.

For PHP files (this applies to **all** PHP files in your project directory), you can use fenced code blocks to specify code that is to be removed or enabled in the distribution version (see `_config.php` for an example):

- use `/*::config:dev*/` ... `/*::config*/` to mark blocks of codes to be removed
- use `/*::config:live` ... `::config*/` to mark blocks of codes to be enabled

License (BSD Simplified)
------------------------

[](#license-bsd-simplified)

Copyright (c) 2013, Thierry Francois (colymba)

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of Thierry Francois, colymba nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

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

---

Top Contributors

[![colymba](https://avatars.githubusercontent.com/u/978040?v=4)](https://github.com/colymba "colymba (20 commits)")

### Embed Badge

![Health badge](/badges/colymba-silverstripe-project-boilerplate/health.svg)

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

PHPackages © 2026

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