Supports light and dark theme switching and mobile adaptation
JekyllPortfolioBlog
jekyll-theme-satellite — Jekyll Portfolio Template
By byanko55
Satellite is a Jekyll-based blog theme offering light and dark themes, hierarchical categories, site search, table of contents, comments, and visitor counting, under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-09-30View source
What stands out
A quick read of the recorded project description.
Search articles by title or tag, supports hierarchical categories and related articles
Article pages provide table of contents navigation, code blocks can be copied with one click and highlighted using highlight.js
Can integrate giscus comments, goatcounter visitor counting, and Google Analytics
Automatically generates RSS and Sitemap
MIT license, free to use, modify, commercialize, and distribute
Template Details
Satellite is a Jekyll-based blog theme with a public repository and online demo, released under the MIT license. The theme provides several built-in capabilities for blog content organization and reading experience: it supports searching articles by title or tag, organizing content by hierarchical categories, displaying related articles, and automatically generating RSS and Sitemap. Article pages provide table of contents navigation, code blocks support one-click copying and syntax highlighting with highlight.js. At the site level, it includes light and dark theme switching, mobile adaptation, and optional giscus comment system, goatcounter visitor counting, and Google Analytics statistics.
There are two installation methods: first, directly fork the repository or download the source code archive; if the target repository is named USERNAME.github.io, the site address is https://USERNAME.github.io/, otherwise you need to modify the baseurl in _config.yml; second, introduce it as a Gem package, which requires creating a clean site directory, removing the default index.markdown and about.markdown, adding jekyll-theme-satellite to the Gemfile, and replacing the initial configuration with the _config.yml provided by the repository. After that, fill in the site title, description, logo, avatar, and social accounts in _config.yml, install dependencies via bundle install, and preview locally with bundle exec jekyll serve.
In terms of usage limitations, external services such as comments and visitor counting need to be enabled separately according to the documentation; the licenses for third-party assets such as demo images, fonts, and icons need to be verified separately and cannot be judged solely based on the MIT license of the code.
JekyllPortfolioBlog
Is it right for your project?
Use Cases
- Build a personal blog and publish text and image articles
- Organize technical or lifestyle content with hierarchical categories and tags
- Blog sites requiring comment interaction, visit statistics, and site search
- Deploy on GitHub Pages as a personal site
Suitable For
- Individual developers building static blogs with Jekyll
- Writers who want to quickly obtain blog features such as light and dark themes, search, and table of contents
- Content site maintainers who need to organize articles by category and tag
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Method 1: Fork the repository or download the source code archive; if the repository is named USERNAME.github.io, the site address is https://USERNAME.github.io/, otherwise set baseurl to /<repo-name> in _config.yml
- 2
Method 2: Create a clean site directory, remove the default index.markdown and about.markdown, add gem "jekyll-theme-satellite" to the Gemfile, and replace the initial configuration with the _config.yml provided by the repository
- 3
Fill in site variables such as site title, description, logo, avatar, and social accounts in _config.yml
- 4
Run locally: first execute bundle install, then bundle exec jekyll serve, and visit http://localhost:4000
- 5
The comment system and visitor counting need to be enabled separately according to the corresponding documentation in the repository's docs directory
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The comment function relies on the giscus external service, which needs to be configured separately according to the repository documentation and may require authorization on a third-party platform; it is not a capability built into the theme code itself.
- Visitor counting relies on the goatcounter external service, which requires registering an account and configuring it yourself; the theme code itself does not provide a counting backend.
- The statistics function relies on the Google Analytics external service, which requires applying for an account and filling in a tracking identifier yourself, and may involve third-party service terms and fees.
- Demo images, fonts, icons, and other third-party assets need to be verified according to their respective licenses and cannot be judged solely based on the MIT license of the code.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Comment System using *giscus*
Original README
Visitor Counter (*goatcounter*)
Original README
https://github.com/byanko55/jekyll-theme-satellite/blob/master/LICENSEhttps://github.com/byanko55/jekyll-theme-satellite/blob/master/README.mdGoogle Analytics
Original README
Compiled by DeepSeek based on repository license and README ·2026-09-30. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 77 / 100
- Technologies
- Jekyll
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2024-05-20
- Screenshot last checked
- 2026-09-30
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 8955c3c9c3db8a568c358ef0106f2e33d1d7162e35bf3aa535f1d859695e13ce
2026-09-30T11:29:51.716Z
Source file / repository[](ci)
[](https://opensource.org/licenses/MIT)
[](https://jekyllrb.com/)
[](gem)
<a href="https://jekyll-themes.com/byanko55/jekyll-theme-satellite">
<img
src="https://img.shields.io/badge/featured%20on-JT-red.svg"
height="20"
alt="Jekyll Themes Shield"
/>
</a>
# Satellite🛰️ - Jekyll blog theme
An emotional and adorable blog theme powered by ***Jekyll***.
Live demo is available [here](https://byanko55.github.io)
### Light Mode
### Dark Mode
### Fresh and Attractive Design
<p>
<img src="https://i.ibb.co/4NwrTyj/image-2.webp" height="400px" align="center"/>
<img src="https://i.ibb.co/WvyBzkL/Animation.gif" height="400px" align="center"/>
</p>
<br></br>
## Features
* Comment System using *giscus*
* Copy contents of Code Block
* Dark/Light Theme
* Google Analytics
* Hierarchical Categorization
* Mobile friendly design
* Related Posts
* RSS/Sitemap support
* Search Post by Title or Tags
* Syntax Highlighter (*highlight.js*)
* Table of Contents
* Visitor Counter (*goatcounter*)
## Installation
There are two ways to setup this theme:
<br></br>
### Method 1: Build from source (Recommended)
Fork [this repository](https://github.com/byanko55/jekyll-theme-satellite) or download the [source](https://github.com/byanko55/jekyll-theme-satellite/releases) as a zip.
If you use as destination a repository named USERNAME.github.io, then your url will be https://USERNAME.github.io/.
Otherwise (let's say `myblog`), you need to edit the '*baseurl*' parameter in `_config.yml`. In this case, the root page will be served to "https://USERNAME.github.io/myblog/".
```yml
# set baseurl as "/<repo-name>". ex) baseurl: /myblog
baseurl: /myblog
```
<br></br>
### Method 2: Utilize Gem package
Create a clean site directory (Follow the **Instruction 1~4** described [here](https://jekyllrb.com/docs/)).
The following materials are redundant, so remove them.
* index.markdown
* about.markdown
<br></br>
Then, add this line to your Jekyll site's `Gemfile`:
```bash
gem "jekyll-theme-satellite"
```
You need to replace the initial `_config.yml` file with the [prepared one](https://github.com/byanko55/jekyll-theme-satellite/blob/master/docs/_config.yml).
<br></br>
### Modify your site setting
Now fill in the **site variable** such as blog name, profile image, and social accounts in `_config.yml`.
```yml
title: Example.com
description: "Satellite - jekyll blog theme"
logo_img: "/assets/img/favicon.webp"
profile_img: "/assets/img/profile.jpg"
# Social Links
email: [email protected]
github_username: github
twitter_username: twitter
instagram_username: instagram
linkedin_username: linkedin
facebook_username: facebook
```
### Run site locally
From the site root directory, install the dependencies:
```
bundle install
```
Start a Jekyll service.
```
bundle exec jekyll serve
```
Now open [http://localhost:4000](http://localhost:4000) in your browser.
<br></br>
## Customizing
You can find useful manuals for customizing your site from the below table:
|||
|---|---|
|Posting guidelines|[link](https://github.com/byanko55/jekyll-theme-satellite/blob/master/docs/Posting%20Guide.md)|
|Enabling ***comment system***|[link](https://github.com/byanko55/jekyll-theme-satellite/blob/master/docs/Comment%20System.md)|
|Enabling ***Visitor counter***|[link](https://github.com/byanko55/jekyll-theme-satellite/blob/master/docs/Visitor%20Counter.md)|
## Contribution
If you would like to report a bug or request a new feature, please open [an issue](https://github.com/byanko55/jekyll-theme-satellite/issues) We are open to any kind of feedback or collaboration.
<br></br>
## License
© 2024 *Yankos*. This theme is available as open source under the terms of the [MIT License](https://opensource.org/license/mit/).
Explore similar templates
Compare previews and descriptions within the same stack and category.
al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio
minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio
Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog
jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog
startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog
So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog