PHPackages                             dahmen/automad-adam - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. dahmen/automad-adam

ActiveAutomad-package[Utility &amp; Helpers](/categories/utility)

dahmen/automad-adam
===================

An elegant multi-purpose theme for Automad

1.1.7(8mo ago)61.9kMITLess

Since Jun 13Pushed 8mo ago2 watchersCompare

[ Source](https://github.com/marcantondahmen/automad-adam)[ Packagist](https://packagist.org/packages/dahmen/automad-adam)[ Fund](https://paypal.me/marcantondahmen)[ GitHub Sponsors](https://github.com/marcantondahmen)[ RSS](/packages/dahmen-automad-adam/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (3)Versions (14)Used By (0)

Adam
====

[](#adam)

The Adam theme is a clean and elegant multi-purpose theme for the [Automad](https://automad.org) CMS. It provides several options to display your content. Please read below more about the main concepts of this theme. Check out the demo page and all available templates [here](https://adam.dev.automad.org).

[![](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/sidebar-left.png)](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/sidebar-left.png)

- [Templates](#templates)
- [Pagelist Configuration](#pagelist-configuration)
- [Title, Navigation, Filtering and Sorting](#title-navigation-filtering-and-sorting)
- [Logo and Brand](#logo-and-brand)
- [Labels](#labels)
- [Date Formats](#date-formats)
- [Social Media Cards](#social-media-cards)
- [Header and Footer Items](#header-and-footer-items)

Templates
---------

[](#templates)

The following templates are included in this theme.

NameDescriptionBlogA blog page grid template. Articles are displayed along with their teaser image, date, tags and the first paragraph.PortfolioA portfolio page grid template. Projects are displayed along with their teaser image, date and tags.PostA blog post template. Related pages are displayed below the main content.ProjectA project page template. Related pages are displayed below the main content.Sidebar LeftA multi-purpose template with a navigation sidebar on the left.Sidebar RightA multi-purpose template with a navigation sidebar on the right.SimpleA simple and basic page template.[![](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/portfolio-full-height.png)](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/portfolio-full-height.png)[![](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/project.png)](https://raw.githubusercontent.com/marcantondahmen/media-files/master/themes/adam/project.png)

Pagelist Configuration
----------------------

[](#pagelist-configuration)

This theme offers multiple options and two templates — **Blog** and **Portfolio** — to create pagelists. The following options can be used to control the content of such a pagelist. Pagelist templates can also be used to create a search results page.

NameDescriptionScopeShow All Pages In PagelistIf checked, the pagelist includes all pages instead of just the direct children.-Filter Pagelist By UrlFilters the pagelist by URLs matching a given regular expression.-Notification No Search ResultsThe notification text for empty search results.SharedItems Per PageThe maximum number of pages to be displayed in a pagelist at once. In case there are more pages to be shown, a pagination navigation will show up below automatically.-Show Pages BelowShow only direct children of a custom local URL like `/custom/page`-Url Search ResultsThe local URL of the pagelist page to be used as the search results page. Note that the search field in the menu is only enabled in case an URL is defined.SharedUrl Tag Link TargetThe target page to navigate to when clicking a tag. By default the parent page is used.-Image TeaserThe filename or glob pattern for the image to be used as the teaser image in a pagelist.-Sort PagelistSorting of the pages in a portfolio or blog pagelist. Note that the sorting and filtering buttons should be hidden in case this variable is defined! The default is 'date desc'. You can choose any other page variable in combination with an order (asc or desc) like ':path asc'.-Sort Related PagesSorting of the pagelist with related pages. The default is 'date desc'. You can choose any other page variable in combination with an order (asc or desc).-Title, Navigation, Filtering and Sorting
----------------------------------------

[](#title-navigation-filtering-and-sorting)

The following checkboxes can be used to control the visibility of pages and elements.

NameDescriptionScopeHide FiltersHide the filter and search reset buttons on a blog page.-Hide Filters And SortHide filter, sort and search reset buttons on a portfolio page.-Hide In MenuHide the page from the main menu.-Hide Prev Next NavHide the previous and next arrow navigation around the title.-Hide TitleHide the page title.-Show In FooterAdd the page to the footer menu.-Show In NavbarAdd the page to the navbar menu.-Logo and Brand
--------------

[](#logo-and-brand)

To set the brand name, a navbar logo and favicons, use the following options.

NameDescriptionScopeBrandThe brand HTML, SVG or text to be used instead of a logo.-Image LogoThe path to your logo - this variable should be defined globally in the shared data section.-Logo HeightThe height of your logo - this variable should be defined globally in the shared data section.-FaviconThe local path to the icon to be used as favicon.SharedImage Apple Touch IconThe image to be used as the Apple touch icon.SharedLabels
------

[](#labels)

All labels, button text, placeholders and notification texts can be overriden or translated as needed. The following variables are therefore available.

NameDescriptionScopeLabel Clear SearchButton text for clearing search results.SharedLabel RealatedLabel for related pages section.SharedLabel Show AllLabel text for filter button when no filter is selected.SharedLabel Sort Date AscLabel text in dropdown for sorting pages by date ascending.SharedLabel Sort Date DescLabel text in dropdown for sorting pages by date descending.SharedLabel Sort Title AscLabel text in dropdown for sorting pages by title ascending.SharedLabel Sort Title DescLabel text in dropdown for sorting pages by title descending.SharedNotification No Search ResultsNotification text for an empty list of search results.Sharedplaceholder SearchPlaceholder text for the search field of the main menu.SharedDate Formats
------------

[](#date-formats)

This theme uses two different date formats. One for blog posts and another one for project pages. It is possible to override those formats to change the way a date appears on a page. Both, PHP's [strftime()](https://www.php.net/manual/en/function.strftime.php#refsect1-function.strftime-parameters) and [date()](https://www.php.net/manual/en/function.date.php#refsect1-function.date-parameters) formats are supported. Note that the locale options can be only used together with the strftime() syntax.

NameDescriptionScopeFormat Date PostThe format for displaying the date of a post.SharedFormat Date ProjectThe format for displaying the date of a project page.SharedLocaleThe locale information to format date and time according to like `en_EN` or `de_DE`SharedSocial Media Cards
------------------

[](#social-media-cards)

This theme automatically generates preview cards when a page is linked in Twitter, Facebook or other social networks. The following options can be used to control the content of those cards.

NameDescriptionScopeMeta DescriptionAn optional meta description to be used for Twitter, Facebook or similar social network cards.-Meta TitleAn optional meta title to be used for the browser title bar and links used on Twitter, Facebook or similar social networks.-Og ImageA glob pattern to select a preview image for Twitter, Facebook or similar social network cards. This could be for example `*.png, *.jpg`.-Header and Footer Items
-----------------------

[](#header-and-footer-items)

Sometimes it is required to add custom Javascript or CSS to one or more pages. This could be for example the case if you would want to add a Google Analytics tracking snippet to your site. Therefore this theme provides two variables for that purpose. The itemsHeader variable lets you add all kind of header items right before the closing `` tag. To add any HTML or JS right before the closing `` tag you can use the itemsFooter variable.

NameDescriptionScopeItems HeaderItems to be inserted before the closing `` tag.-Items FooterItems to be inserted before the closing `` tag.-

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance62

Regular maintenance activity

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity63

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

Recently: every ~81 days

Total

13

Last Release

242d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7a3565413eb5da0526ac25a008fa743c1cd4f30ef1fd5eb17bcfee7e8c6ac5be?d=identicon)[marcantondahmen](/maintainers/marcantondahmen)

---

Top Contributors

[![marcantondahmen](https://avatars.githubusercontent.com/u/8440030?v=4)](https://github.com/marcantondahmen "marcantondahmen (47 commits)")

---

Tags

automadthemethemeblogportfoliomulti-purpose

### Embed Badge

![Health badge](/badges/dahmen-automad-adam/health.svg)

```
[![Health](https://phpackages.com/badges/dahmen-automad-adam/health.svg)](https://phpackages.com/packages/dahmen-automad-adam)
```

###  Alternatives

[dahmen/automad-terminal

A minimal Automad blog theme for terminal lovers

522.3k](/packages/dahmen-automad-terminal)

PHPackages © 2026

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