PHPackages                             imarc/padstone - 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. imarc/padstone

ActiveProject[Framework](/categories/framework)

imarc/padstone
==============

Craft CMS

5.2.2(1y ago)214376[2 issues](https://github.com/imarc/padstone/issues)[1 PRs](https://github.com/imarc/padstone/pulls)Twig

Since Apr 22Pushed 1y ago8 watchersCompare

[ Source](https://github.com/imarc/padstone)[ Packagist](https://packagist.org/packages/imarc/padstone)[ RSS](/packages/imarc-padstone/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (8)Dependencies (18)Versions (120)Used By (0)

 [![](https://user-images.githubusercontent.com/1452/57405127-a7331580-71ab-11e9-8d16-0ee4a9c55328.jpg)](https://user-images.githubusercontent.com/1452/57405127-a7331580-71ab-11e9-8d16-0ee4a9c55328.jpg)

Padstone for Craft CMS
======================

[](#padstone-for-craft-cms)

Padstone is a starter package for Craft 4 built by Imarc. It provides a simple project config as well as example entries and templates.

*If you would like to use the older version of Padstone for Craft 2 or 3, see the [craft2 branch](https://github.com/imarc/padstone/tree/craft2) or [4.x](https://github.com/imarc/padstone/tree/4.x).*

Features
--------

[](#features)

- Pre-built CMS sections, including ones for the Homepage, a Blog, News, and Resources. (18 in total!)
- A set of [Imarc Boilerplate](https://github.com/imarc/boilerplate-components) twig templates for you to replace or customize.
- A neo-based **Content Designer** field, built within Craft, for laying out pages beyond simple rich text.
- A set of plugins selected by Imarc that we recommend for new projects.

Getting Started
---------------

[](#getting-started)

Create a new padstone project with the following [composer](https://getcomposer.org/) command:

```
composer create-project imarc/padstone [folder]
```

### Using [ops](https://github.com/imarc/ops) (the fast way)

[](#using-ops-the-fast-way)

Go into your the new project folder, and run

```
ops padstone-install
```

This will run all the following steps, including prompting you for values to add to your .env file. You likely want to leave DB\_SERVER as `mariadb` (the default), but you can change the other settings if you'd like.

### The manual way

[](#the-manual-way)

1. Copy .env.example to be .env and update settings inside. In particular, DB\_DATABASE, DB\_SERVER, DB\_USER and DB\_PASSWORD.
2. Run `./craft setup/security-key` to generate a SECURITY\_KEY for your .env file.
3. If you'd like to use Padstone's SQL file, import padstone.sql into your site.
4. The default Padstone site is configured to [store user sessions in the database](https://docs.craftcms.com/v3/config/app.html#session-component). The phpsessions table needs to be added to the new database. If you import the padstone.sql file the table will be created by the import. As an alternative, you can create the table manually by runnng the craft console command.

    craft setup/php-session-table

Then run the installer by going to /admin (except for your domain.)

Logging in
----------

[](#logging-in)

If you use the ops method or import `padstone.sql` manually, the username is *admin* and the password is *padstone*. Please change the password after you first login.

Front-End Build
---------------

[](#front-end-build)

Beyond the typical craft files, you will also see a resources/ folder. Padstone uses [Laravel Mix](https://laravel-mix.com/docs/4.0/basic-example) to compile JS and Sass files from the resources/ folder and store the results into the public/ folder:

- `resources/assets/sass/main.scss` is compiled to `public/css/main.css`
- `resources/assets/js/main.js` is compiled to `public/js/main.js`

Additionally, Padstone produces `manifest.js` and `vendor.js` files that must be included, in that order, before any of your own JS files. You can customize this behavior in `webpack.mix.js`.

### Watching/Building assets

[](#watchingbuilding-assets)

While developing, you most likely want to watch the files you are working on, so the build happens automatically after every save.

```
npm run watch

```

If you want to run this same build process for dev without watching, you can run the following:

```
npm run dev

```

If you are building to production, run:

```
npm run prod

```

What's Included
---------------

[](#whats-included)

### Sections

[](#sections)

Padstone includes the following sections:

- **Homepage**
- **Pages** with entry types for **Blog**, **News**, **Resources**, **Team**, and **Contact** pages
- **Shared Sections** for building shared pieces of of pages
- **Blog Articles**, **News Articles** and **Authors**
- **Team**, **Events** and **Resources**
- **Alerts**
- **Error Page** and **404 Page**

### Plugins

[](#plugins)

The following plugins are currently included and installed via [composer](https://getcomposer.org/), which is what Craft uses for the Plugin Store as well:

- [Admin Bar](https://plugins.craftcms.com/admin-bar)
- [CodeMirror](https://plugins.craftcms.com/code-mirror)
- [Contact Form Honeypot](https://plugins.craftcms.com/contact-form-honeypot)
- [Contact Form](https://plugins.craftcms.com/contact-form)
- [Craft Kindling](https://github.com/imarc/craft-kindling)
- [Element API](https://github.com/craftcms/element-api)
- [Expanded Singles](https://plugins.craftcms.com/expanded-singles)
- [Feed Me](https://github.com/craftcms/feed-me)
- [Field Manager](https://github.com/verbb/field-manager)
- [Google Custom Search](https://github.com/imarc/craft-googlecustomsearch)
- [Mix](https://plugins.craftcms.com/mix)
- [Neo](https://github.com/spicywebau/craft-neo)
- [Redactor](https://plugins.craftcms.com/redactor)
- [Retour](https://plugins.craftcms.com/retour)
- [Sprout Fields](https://sprout.barrelstrengthdesign.com/docs/fields/)
- [Super Table](https://github.com/verbb/super-table)
- [Tags](https://plugins.craftcms.com/tag-manager)
- [Typed link field](https://plugins.craftcms.com/typedlinkfield)

#### Suggested Additional Plugins

[](#suggested-additional-plugins)

These plugins didn't make the cut for Padstone, but they are plugins we'd recommend people look at if they have specific needs:

- [Guide](https://plugins.craftcms.com/guide) - add documentation with Craft. Currently $39 and $19/year.
- [Maps](https://docs.ethercreative.co.uk/maps/) - a Map field type for picking locations that works with Google Maps and other services.
- [Sprout Forms](https://sprout.barrelstrengthdesign.com/docs/forms/) - a form builder that can track submissions within Craft.

### Macros

[](#macros)

There is a `_macros.twig` file that provides The following macros:

- **renderAllBlocks**, **renderBlock**, and **renderColumn** - these are used to render the contentDesigner field.
- **responsiveImage** - macro that uses the responsiveImage.twig partial to embed an image with an appropriate picture tag with srcsets for working with lazysizes.
- **pagination** - used to generate pagination.
- **commaSeparate** - used to generate a comma separated list of elements based on title.
- **columnsSlug** - used to generate a classname appropriate slug for for a section.
- **numberToWord** - used to convert a number from 0 through 10 to an english word.

### Sections

[](#sections-1)

The **Content Designer** Field (contentDesigner) allows CMS users to use the following sections out of the box:

- **Designed Section** - the most common section, it allows you to pick a combination of up to two columns to render together out of the following:
    - Text - a regular rich text column. Within a Text column, you can additionally add a Call to Action.
    - Call to Action - a call to action, typically styled to look like a button.
    - Image - an image.
    - Related Entry - a related entry.
    - Testimonial - a testimonial.
    - Video - a video.
    - Embed - an embed.
- **Rich Text Section** - a more traditional section of just rich text, relying on redactor for styling or floating images within the content.
- **Call to Action Section** - A full width section featuring a call to action.
- **Related Entries Section** - A section of related entries, such as related blog articles or resources.
- **Testimonial Section** - A section featuring a testimonial.
- **Icon Grid Section** - An icon grid, typically used to showcase partner, brand or technology logos.
- **Shared Section** - allows you to include a Shared Section, a separate type of entry in the CMS that itself contains a Content Designer field. This lets you build a block once (within a Shared Section) and include it into multiple pages on the site.

License
-------

[](#license)

Padstone is released under the MIT License.

Contributing
------------

[](#contributing)

Set up a padstone project with the ability to contribute back.

```
# clone project and enter directory
git clone git@github.com:imarc/padstone.git
cd padstone

# install composer deps
composer install

# create .env file. if you are using Ops, you can copy .env.example.ops
cp .env.example.server .env

# generate craft security key
php craft setup/security-key

# install boilerplate components
npx imarc/boilerplate-components
echo '@import "~bootstrap/scss/bootstrap";' >> resources/styles/main.scss"
echo 'import "bootstrap";' >> resources/js/main.js"

# import sql into db. If you are using Ops, the command is:
ops mariadb import padstone padstone.sql

# Manual step:
# set DB_DATABASE in your .env to 'padstone'

```

[![Imarc](https://user-images.githubusercontent.com/1452/56690112-b04fbd00-66aa-11e9-9e87-049b403cfa26.png)](https://user-images.githubusercontent.com/1452/56690112-b04fbd00-66aa-11e9-9e87-049b403cfa26.png)

© 2019-2022 Imarc

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance45

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 73.8% 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 ~37 days

Recently: every ~245 days

Total

89

Last Release

398d ago

Major Versions

1.6.3 → 2.0.02018-02-12

2.1.2 → 3.0.02019-03-12

3.x-dev → 4.0.0-beta.12021-04-27

4.2.3 → 5.0.0-alpha.12022-06-13

4.x-dev → 5.0.02022-09-12

PHP version history (3 changes)3.0.0PHP >=7.0.0

3.8.0-beta.1PHP >=7.2.5

5.0.0-alpha.1PHP ^8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/00725533df5fd021ac93639028725bf46bef78f6d924618a987b9bfd5c32c3eb?d=identicon)[jeffturcotte](/maintainers/jeffturcotte)

![](https://www.gravatar.com/avatar/4c423d4aa457201693aadc0ffd67895f3383709e89c66547949d65a37123ee22?d=identicon)[khamer](/maintainers/khamer)

![](https://avatars.githubusercontent.com/u/42547992?v=4)[Dave Anastasi](/maintainers/daveanastasi)[@daveanastasi](https://github.com/daveanastasi)

---

Top Contributors

[![khamer](https://avatars.githubusercontent.com/u/1452?v=4)](https://github.com/khamer "khamer (186 commits)")[![kerrig](https://avatars.githubusercontent.com/u/1864417?v=4)](https://github.com/kerrig "kerrig (36 commits)")[![jeffturcotte](https://avatars.githubusercontent.com/u/65089?v=4)](https://github.com/jeffturcotte "jeffturcotte (17 commits)")[![LinneaImarc](https://avatars.githubusercontent.com/u/115502772?v=4)](https://github.com/LinneaImarc "LinneaImarc (7 commits)")[![BillBushee](https://avatars.githubusercontent.com/u/366423?v=4)](https://github.com/BillBushee "BillBushee (4 commits)")[![dtcollins](https://avatars.githubusercontent.com/u/3641365?v=4)](https://github.com/dtcollins "dtcollins (1 commits)")[![ogdendavis](https://avatars.githubusercontent.com/u/34392374?v=4)](https://github.com/ogdendavis "ogdendavis (1 commits)")

---

Tags

craftcraft3craftcmshacktoberfeststarter-kit

### Embed Badge

![Health badge](/badges/imarc-padstone/health.svg)

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

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)

PHPackages © 2026

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