{"id":13567425,"url":"https://github.com/amitmerchant1990/reverie","last_synced_at":"2025-05-14T00:07:36.458Z","repository":{"id":41287898,"uuid":"170373917","full_name":"amitmerchant1990/reverie","owner":"amitmerchant1990","description":":art: A ridiculously elegant Jekyll theme.","archived":false,"fork":false,"pushed_at":"2025-03-23T05:40:24.000Z","size":3435,"stargazers_count":832,"open_issues_count":12,"forks_count":729,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-05-13T03:48:53.764Z","etag":null,"topics":["blog","blog-theme","github-page","github-pages","hacktoberfest","jekyll","jekyll-blog","jekyll-theme","responsive-design","responsive-theme"],"latest_commit_sha":null,"homepage":"https://reverie.pages.dev","language":"SCSS","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amitmerchant1990.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"amitmerchant1990","custom":"paypal.me/AmitMerchant","patreon":"amitmerchant"}},"created_at":"2019-02-12T19:00:55.000Z","updated_at":"2025-05-11T11:43:58.000Z","dependencies_parsed_at":"2024-01-03T03:41:27.805Z","dependency_job_id":"5b7e94da-42c7-487e-9b77-7f9bc36a3185","html_url":"https://github.com/amitmerchant1990/reverie","commit_stats":{"total_commits":123,"total_committers":15,"mean_commits":8.2,"dds":"0.13008130081300817","last_synced_commit":"23b3723ccd0b40ecd1034e65b7e41795f68b92e4"},"previous_names":[],"tags_count":2,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitmerchant1990%2Freverie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitmerchant1990%2Freverie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitmerchant1990%2Freverie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitmerchant1990%2Freverie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amitmerchant1990","download_url":"https://codeload.github.com/amitmerchant1990/reverie/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254043808,"owners_count":22005020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","blog-theme","github-page","github-pages","hacktoberfest","jekyll","jekyll-blog","jekyll-theme","responsive-design","responsive-theme"],"created_at":"2024-08-01T13:02:31.172Z","updated_at":"2025-05-14T00:07:36.442Z","avatar_url":"https://github.com/amitmerchant1990.png","language":"SCSS","funding_links":["https://github.com/sponsors/amitmerchant1990","paypal.me/AmitMerchant","https://patreon.com/amitmerchant","https://paypal.me/AmitMerchant","https://buymeacoffee.com/amitmerchant"],"categories":["SCSS","jekyll-theme"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"/images/reverie-text.png\" alt=\"Reverie\" width=\"200\"/\u003e\n  \u003cbr\u003e  \n  \u003cp align=\"center\"\u003e\n    \u003ci\u003eSupport my work via \u003ca href=\"https://paypal.me/AmitMerchant\"\u003ePaypal\u003c/a\u003e or \u003ca href=\"https://buymeacoffee.com/amitmerchant\"\u003eBuy me a coffee\u003c/a\u003e\u003c/i\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\nReverie is a [Jekyll](https://jekyllrb.com/)-powered theme which is simple and opinionated. It's actually a fork of [jekyll-now](https://github.com/barryclark/jekyll-now) with some additional features and personal touches which I've implemented to suit my needs for my blog.\n\n\u003e [Theme demo](https://reverie.pages.dev/)\n\nThis is a plug-and-play Jekyll theme best suited to use on [GitHub Pages](https://pages.github.com) (or [Cloudflare Pages](https://pages.cloudflare.com/) if you want to have your repository private) without even setting up a local environment.\n\n![](/images/reverie-demo.png)\n\n|  Responsiveness            |  Search | Categories |\n|---------------------|----------------------|----------------------|\n|![Responsiveness](/images/mobile-demo.png) | ![search](/images/search.png) | ![categories](/images/categories.png) |\n\n# Table of Contents\n  - [Features overview](#features-overview)\n  - [Using Reverie on GitHub Pages](#using-reverie-on-github-pages)\n    - [1. Fork Reverie to your User Repository](#1-fork-reverie-to-your-user-repository)\n    - [2. Customize and view your site](#2-customize-and-view-your-site)\n    - [3. Publish your first blog post](#3-publish-your-first-blog-post)\n  - [Using Categories in Reverie](#using-categories-in-reverie)\n  - [Pagination](#pagination)\n  - [RSS](#rss)\n  - [Sitemap](#sitemap)\n  - [Troubleshooting](#troubleshooting)\n  - [Emailware](#emailware)\n  - [The name?](#the-name)\n  - [License](#license)\n\n{:toc}\n\n## Features overview\n\n- Clean and minimal design\n- Single column post layout\n- Command-line free fork-first workflow, using GitHub.com to create, customize and post to your blog\n- Fully responsive and mobile optimized theme\n- Sass/Coffeescript support using Jekyll 2.0\n- Free hosting on your GitHub Pages user site\n- All the SEO goodies come built-in\n- Markdown blogging\n- Supports [Pullquotes](https://reverie-jekyll.netlify.app/pullquotes/)\n- Syntax highlighting using Pygments\n    - [Dracula syntax theme](https://draculatheme.com/) included\n- Disqus commenting\n- Social media icons\n- Google Analytics integration\n- Supports [Google Analytics 4](https://support.google.com/analytics/answer/10089681?hl=en)\n- Fuzzy search across blog posts\n- Blog with pagination\n- Categorize posts out-of-the box\n- RSS Feed\n- Built-in sitemap\n\n\u003e \u003cp\u003e\u003ci\u003eLike this theme?\u003c/i\u003e If so, consider donating a small amount that will help my maintaining this project further.\u003cp\u003e\n\u003e You can support me via \u003ca href=\"https://paypal.me/AmitMerchant\"\u003ePaypal\u003c/a\u003e.\n\n## Using Reverie on GitHub Pages\n\nSetting up Reverie on GitHub Pages is as simple as it gets!\n\n### 1. Fork Reverie to your User Repository\n\nFork this repository, then rename the repository to `yourgithubusername.github.io`.\n\nAlternatively, you can click the [`Use this template`](https://github.com/amitmerchant1990/reverie/generate) button if you want to create a repository with a clean commit history which will use Reverie as a template.\n\nYour Jekyll blog will often be viewable immediately at \u003chttps://yourgithubusername.github.io\u003e (if it's not, you can often force it to build by completing step 2).\n\n### 2. Customize and view your site\n\nEnter your site name, description, avatar and many other options by editing the `_config.yml` file. You can easily turn on Google Analytics tracking, Disqus commenting and social icons here.\n\nMaking a change to `_config.yml` (or any file in your repository) will force GitHub Pages to rebuild your site with Jekyll. Your rebuilt site will be viewable a few seconds later at \u003chttps://yourgithubusername.github.io\u003e - if not, give it ten minutes as GitHub suggests and it'll appear soon.\n\n### 3. Publish your first blog post\n\nDelete all files from `_posts`directory and create a new file called `/_posts/2019-2-13-Hello-World.md` to publish your first blog post. That's all you need to do to publish your first blog post! This [Markdown Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) might come in handy while writing the posts.\n\n\u003e You can add additional posts in the browser on GitHub.com too! Just hit the \u003ckbd\u003eCreate new file\u003c/kbd\u003e button in `/_posts/` to create new content. Just make sure to include the [front-matter](http://jekyllrb.com/docs/frontmatter/) block at the top of each new blog post and make sure the post's filename is in this format: year-month-day-title.md\n\n## Using Categories in Reverie\n\nYou can categorize your content based on `categories` in Reverie. For this, you just need to add `categories` in front matter like below:\n\nFor adding single category:\n\n```md\ncategories: JavaScript\n```\n\nFor adding multiple categories:\n\n```md\ncategories: [PHP, Laravel]\n```\n\nThe categorized content can be shown over this URL: \u003chttps://yourgithubusername.github.io/categories/\u003e\n\n## Pagination\n\nPagination of posts in Reverie works out-of-the-box. You only need to specify the number of posts you want on a single page in `_config.yml` and Reverie will take care of the rest.\n\n```yml\npaginate: 6\n```\n\n## RSS\n\nReverie comes with a [RSS feed](https://en.wikipedia.org/wiki/RSS) in-built. The generated RSS Feed of your blog can be found at \u003chttps://yourgithubusername.github.io/feed\u003e. You can see the example RSS feed over [here](https://reverie-jekyll.netlify.app/feed.xml).\n\n## Sitemap\n\nThe generated sitemap of your blog can be found at \u003chttps://yourgithubusername.github.io/sitemap.xml\u003e. You can see the example sitemap feed over [here](https://reverie-jekyll.netlify.app/sitemap.xml).\n\n## Troubleshooting\n\nThere might be instances where your site based on Reverie won't have the styling working as expected. \n\nThe common reason for this issue is the incorrect `baseurl` set in the `_config.yml` file. You need to use the `baseurl` according to where you're hosting it.\n\nSo, for instance, if you're hosting your site at a Project repository on GitHub pages (http://yourusername.github.io/repository-name) and NOT your user repository (http://yourusername.github.io) then the `baseurl` will be `/repository-name`.\n\nOtherwise the `baseurl` will be `/`.\n\n## Emailware\nReverie is an [emailware](https://en.wiktionary.org/wiki/emailware). Meaning, if you liked using this theme or it has helped you in any way, I'd like you send me an email at \u003cbullredeyes@gmail.com\u003e about anything you'd want to say about this software. I'd really appreciate it!\n\n## The name?\n\nreverie - _a state of being pleasantly lost in one's thoughts; a daydream._\u003cbr\u003e\u003csup\u003e/ˈrɛv(ə)ri/\u003c/sup\u003e \n\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famitmerchant1990%2Freverie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famitmerchant1990%2Freverie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famitmerchant1990%2Freverie/lists"}