Skip to content

cbirdsong/minimum-viable-wordpress

Repository files navigation

Minimum Viable WordPress

A minimalist single-file WordPress theme. Written with semantic and accessible HTML and styled using a modified version of MVP.css.

This was originally designed as a fallback in case Timber fails to load, but it also works as a minimalist theme.

Preview screenshot; it's got no pictures and extremely basic styling.

Supported Features

These WordPress features have been tested:

  • Site name, tagline and custom logo
  • Navigation menus
  • Posts and pages
  • Excerpts and <!--more-->
  • Featured images (post thumbnails)
  • Tags and categories
  • Block editor (Gutenberg)

These should work but haven't been extensively tested:

  • Forms and form plugins
  • Favicons

It does not support:

  • 404 pages
  • Wide/full block alignments
  • Translation/RTL languages
  • Search
  • Authors and author pages
  • Post formats
  • Comments
  • Sidebars and widgets
  • Custom backgrounds, headers and footers
  • Custom post types
  • Custom taxonomies
  • Custom fields

Usage

Within a Timber theme

Copy the index.php file to your theme and rename it minimum-viable-wordpress.php (or whatever), then add this chunk of code to functions.php file:

if ( ! class_exists( 'Timber' ) ) {
	add_filter(
		'template_include',
		function( $template ) {
			return get_stylesheet_directory() . '/minimum-viable-wordpress.php'; // or whatever
		}
	);
	return;
}

This was tested with Timber 1.x.

As a standalone theme

Download a copy of this repository and upload it to the WordPress backend under Appearance > Themes.

Roadmap

  • Clean up fork of MVP.css.
  • Figure out how to detect 404 pages without using 404.php.

Contributing

This project was designed to be extremely lean. Pull requests are welcome for minor bugfixes or enhancements. For major changes or additions, please open an issue and I'd be happy to discuss!

License

GPLv2, as you do for WordPress.

About

A single-file WordPress theme.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published