Azure is a minimal theme for Ghost focused on professional sites and portfolios. The theme is simple and highly configurable, emphasizing clean aesthetics and reader-friendliness.
Demo: https://halabi.me
- Download the theme ZIP file
- Log into Ghost and navigate to the
Themesettings - Change theme by uploading the downloaded ZIP file
- Customizable header with primary and secondary text options
- Flexible hero layout with configurable image positioning
- Call-to-Action (CTA) buttons with customizable text and links
- Portfolio section for showcasing your projects
- Writing section for your blog posts
- Multiple navigation layout options
- Custom typography options
Projects are implemented as pages with the tag #portfolio-case:
- Create a page in Ghost for each project
- Add the
#portfolio-casetag to the page - Set a featured image for visual appeal
- Write a custom excerpt that will appear in the project listings
- Projects are ordered by their published date on both the home page and the projects page
Writings are implemented as regular posts:
- Create posts normally in Ghost
- No special tags are required
- Posts are ordered by their published date on both the home page and the writing page
To create dedicated listing pages for projects and writings:
-
Projects Page: Create a page with the URL
/projects- The theme automatically applies the project listing template
- You can add a title and content to this page - the project listings will appear below
-
Writing Page: Create a page with the URL
/writing- The theme automatically applies the writing listing template
- Any content you add to this page will appear above the post listings
Customize the theme by navigating to Design & branding in Ghost. The following options are available:
- Background Color: Set the main background color for your site
- Typography: Choose from:
- Modern sans-serif (default)
- Elegant serif
- Consistent mono
- Footer Text: Customize the text in the footer (defaults to site name + current year)
- Navigation Layout: Choose from Logo on the left (default), Logo in the middle, or Stacked
- Navigation Alignment: Set to Left (default) or Right
- Hero Layout: Choose from Image Left (default) or Image Right
- Primary Header: Main heading text on the homepage
- Secondary Header: Subheading text on the homepage
- Primary CTA Label: Text for the main CTA button
- Primary CTA Link: URL for the main CTA button (e.g.,
/contact) - Secondary CTA Label: Text for the secondary CTA button
- Secondary CTA Link: URL for the secondary CTA button (e.g.,
/services)
Note: Create corresponding pages for CTA links (e.g., contact page, services page)
- Portfolio Section Title: Customize the portfolio section heading (default: "Projects")
- Portfolio Page URL: Set the URL for the full portfolio page (default: "/projects")
- Writings Section Title: Customize the writings section heading (default: "Writing")
- Writings Page URL: Set the URL for the full writings page (default: "/writing")
Azure includes support for several optional features that can be enabled through Ghost's code injection:
- Contact Modal - Display a contact form when users click on your CTA buttons
- Emoji to Icons Conversion - Automatically convert emojis to Bootstrap icons
This theme uses Gulp and PostCSS for style compilation. Ensure you have the following installed:
Setup and development workflow:
# Install dependencies
npm install
# Build and watch for changes
gulp dev
# Generate distribution ZIP
gulp zipCSS files in /assets/css/ are automatically compiled to /assets/built/.
The gulp zip command packages the theme files into dist/azure.zip, ready for upload to your Ghost site.
Contributions are welcome! Please fork the repository, commit, push and submit a pull request for review.
Copyright (c) 2025 Ammar Halabi - Released under the MIT license.
This theme is loosely based on the Solo theme, and inspired by Medium.