Publishing Themes

Are you ready to publish your newly built theme to our themes list? To do that, your theme should be developed within a fork of our hyvor-blogs-themes repository. After everything is completed, send us a pull request to the main branch. If merged, your theme will be automatically added to our theme list, and other bloggers can install it easily.

All themes in our themes list are free. If you wish to create a paid theme, you have to sell it outside our platform, and users can upload the ZIP from the Console to install it.

Checklist

Has at least these templates
- index.twig
- post.twig
- tag.twig
- author.twig
Supports multi-languages
All posts should have links to translated versions of them (if available). Ex: "This post is also available in..." or "Translations: ..."
Supports both light and dark color modes
Respects the blog's color mode settings
Pagination
All placeholders are added
- _head
- _foot
- _comments
- _newsletter
_comments should only be added to posts, not pages.
_comments and _newsletter blocks should not be displayed if the value of each is empty.
If the blog has a logo (_blog.logo_url), the logo should be shown in the header linking the logo to the blog homepage.
Internationalized
<html lang="{{ _lang.code }}" is added
Configurations are added for colors, fonts, etc.
Mobile responsive
Featured posts may have some unique UI in the index page (ex: a pinned/star icon)
Content Styles:
- All blocks are styled properly. You can test this with the "Content Style" post in your DEV blog.
- Code blocks (<pre><code>) should have tab-size: 4
All assets (JS, fonts, etc.) should be added in the assets folder. Do not load assets from external sources like Google Fonts.
Should support the blog's social media links
- Facebook
- Twitter
- Linkedin
- Youtube
- TikTok
- Instagram
- Github

Config

As explained in the configurations page, the following configurations are required when publishing your theme.

THEME_NAME: my-theme
THEME_VERSION: 1.0.0

The following configurations are recommended for all published themes.

colors:
  light:
    # ... colors for the light theme
  dark:
    # ... colors for the dark theme

# if only one font
font:
  size: 16px
  line_height: 1
  family: 'Inter, sans-serif'

# if multiple fonts
fonts:
  body:
    size: 16px
    family: 'Inter, sans-serif'
  heading:
    size: 24px
    family: 'Nunito, sans-serif'

settings:
  loop: # features in the index page (list of posts)
    authors: true
    tags: true
    featured_image: true
  post: # features in the post page
    authors: true
    tags: true
    featured_image: true
  feed: true # a link to RSS feed (if available)

Versioning

Versioning is important. Use semantic versioning.

Once everything is completed, send us a pull request to the . When the PR is merged, the themes list will automatically