PHPackages                             spress-add-ons/clean-blog-theme - 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. [Templating &amp; Views](/categories/templating)
4. /
5. spress-add-ons/clean-blog-theme

ActiveSpress-theme[Templating &amp; Views](/categories/templating)

spress-add-ons/clean-blog-theme
===============================

Clean blog theme for Spress design by Start Bootstrap

v2.1.0(8y ago)2116↓100%4[1 issues](https://github.com/spress-add-ons/Clean-blog-theme/issues)Apache-2.0JavaScript

Since Jan 25Pushed 8y ago1 watchersCompare

[ Source](https://github.com/spress-add-ons/Clean-blog-theme)[ Packagist](https://packagist.org/packages/spress-add-ons/clean-blog-theme)[ RSS](/packages/spress-add-ons-clean-blog-theme/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Clean blog theme
----------------

[](#clean-blog-theme)

Clean blog theme is a ported theme to Spress designed by [Start Bootstrap](http://startbootstrap.com/).

[Live demo](http://spress-add-ons.github.io/clean-blog/).

[![Spresso theme preview](/screenshot.png)](/screenshot.png)

### Features

[](#features)

- Fully responsive.
- Distraction free blog text optimized for legibility.
- Support for tags and categories in posts.
- Contact form powered by [getsimpleform](https://getsimpleform.com/).
- Comments powered by [Disqus](https://disqus.com).
- Code highlighted thanks to [highlight.js](https://highlightjs.org/).

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

[](#installation)

You can create a [site based on Clean blog](#creating-a-new-site-based-on-this-theme-creating-site)or install this one as a theme of a [pre-existing site](#install-as-a-theme-of-pre-existing-site-pre-existing).

**Requirements:**

- Spress &gt;= 2.2.0

### Creating a new site based on this theme

[](#creating-a-new-site-based-on-this-theme)

Performs the following command and clean-blog theme will be installed in `mysite` folder:

```
$ spress new:site mysite spress-add-ons/clean-blog-theme
```

### Install as a theme

[](#install-as-a-theme)

Go to your site folder and performs the following command:

```
$ spress add:plugin spress-add-ons/clean-blog-theme
```

And add this line to the `config.yml` file of your site:

```
themes:
    name: "spress-add-ons/clean-blog-theme"
```

### How to update?

[](#how-to-update)

You can get the latest version of Clean blog theme with just run the following command:

```
$ spress update:plugin
```

Contents
--------

[](#contents)

### Layouts

[](#layouts)

Refers to files within the `./src/layouts` directory, that define the architecture of the content.

- `default.html`: The base layout. The derived layouts inject their contents into this file at the line that says `{{ page.content }}`.
- `page.html`: Layout for pages.
- `post.html`: Layout for posts. They are located at `./src/content/posts`.
- `collection.html`: Layout used by collection pages: `categories.html` and `tags.html`.

### Includes

[](#includes)

Refers to snippets of code within the `./src/includes` directory. These ones can be inserted in layouts and pages.

- `head.html`: Defines the content of `` in default layout.
- `footer.html`: Defines the default footer section.
- `nav.html`: Defines de top-menu based on pages with title.
- `paginator.html`: Defines the pagination of the content.

Configuration
-------------

[](#configuration)

### Comments

[](#comments)

Comments are powered by [Disqus](disqus.com) and they need a **disqus shortname**. To get it, you need to create an account at this service. It's free.

```
comments:
  enabled: true
  disqus_shortname: "your-shortname"
```

### Top menu

[](#top-menu)

The top menu is composed by each of **pages with `title` attribute**. e.g: `./src/content/about.md`:

```
title: "About me"
```

### Contact form

[](#contact-form)

The contact form is a AJAX form configured in `config.yml`:

```
forms:
    contact:
        getsimpleform_api_token:
```

You need a API key from [getsimpleform](https://getsimpleform.com/) service. It's free.

### Writing a post

[](#writing-a-post)

To create a new post, runs `new:post` command from Spress:

```
$ spress new:post
```

Each post could has a header and thumbnail image. You can configure your image and some data about it:

```
header_img:
  url: "assets/img/post-bg-07.jpg"
  author: "Yuri Samoilov"
  author_url: "https://flic.kr/p/mjhDwB"
```

#### Thumbnail images

[](#thumbnail-images)

The `index.html` page can display a thumbnail image for each post. This kind of images must be located at `./src/content/assets/img` folder and the image may has the dimentions `100x100 px`.

At the `thumb_img` key you can set the name of the image file like this:

```
thumb_img: spress.png
```

License
-------

[](#license)

The theme is available as open source under the terms of the [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0).

###  Health Score

28

—

LowBetter than 57% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity65

Established project with proven stability

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

Total

3

Last Release

3228d ago

Major Versions

v1.0.0 → v2.0.02016-01-01

### Community

Maintainers

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

---

Top Contributors

[![yosymfony](https://avatars.githubusercontent.com/u/3321099?v=4)](https://github.com/yosymfony "yosymfony (38 commits)")

---

Tags

spressthemetemplateblogbootstrapresponsivestartbootstrapspress

### Embed Badge

![Health badge](/badges/spress-add-ons-clean-blog-theme/health.svg)

```
[![Health](https://phpackages.com/badges/spress-add-ons-clean-blog-theme/health.svg)](https://phpackages.com/packages/spress-add-ons-clean-blog-theme)
```

###  Alternatives

[almasaeed2010/adminlte

AdminLTE - admin control panel and dashboard that's based on Bootstrap 4

45.3k8.3M128](/packages/almasaeed2010-adminlte)[mopa/bootstrap-bundle

Easy integration of twitters bootstrap into symfony2

7052.9M33](/packages/mopa-bootstrap-bundle)[acacha/admin-lte-template-laravel

AdminLTE template applied to Laravel Scaffolding

1.8k386.4k8](/packages/acacha-admin-lte-template-laravel)[tightenco/jigsaw-blog-template

Blog starter template for Jigsaw static site generator by Tighten

9463.3k](/packages/tightenco-jigsaw-blog-template)[mopa/bootstrap-sandbox-bundle

Seperate live docs from code

256.8k](/packages/mopa-bootstrap-sandbox-bundle)

PHPackages © 2026

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