{"id":15200204,"url":"https://github.com/benjammin4dayz/jekyll-themes","last_synced_at":"2026-02-06T04:03:01.067Z","repository":{"id":191028992,"uuid":"683162937","full_name":"benjammin4dayz/jekyll-themes","owner":"benjammin4dayz","description":"Ruby Gems and demos for my Jekyll themes","archived":false,"fork":false,"pushed_at":"2023-09-29T10:35:04.000Z","size":113,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"flow-src","last_synced_at":"2025-07-13T10:49:21.455Z","etag":null,"topics":["demo-site","jamstack","jekyll","jekyll-themes","ruby-gem","theme-gem","themes","web-development","webdev"],"latest_commit_sha":null,"homepage":"https://benjammin4dayz.github.io/jekyll-themes/","language":"JavaScript","has_issues":true,"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/benjammin4dayz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2023-08-25T18:42:18.000Z","updated_at":"2023-09-16T05:47:04.000Z","dependencies_parsed_at":"2023-08-27T19:45:21.643Z","dependency_job_id":"c2ec42c6-fbba-41df-a4ce-4b48066b75f3","html_url":"https://github.com/benjammin4dayz/jekyll-themes","commit_stats":{"total_commits":70,"total_committers":1,"mean_commits":70.0,"dds":0.0,"last_synced_commit":"3f8d26004eb245d283cf2bee3ce0433094730fd6"},"previous_names":["benjammin4dayz/jekyll-themes"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/benjammin4dayz/jekyll-themes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjammin4dayz%2Fjekyll-themes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjammin4dayz%2Fjekyll-themes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjammin4dayz%2Fjekyll-themes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjammin4dayz%2Fjekyll-themes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benjammin4dayz","download_url":"https://codeload.github.com/benjammin4dayz/jekyll-themes/tar.gz/refs/heads/flow-src","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjammin4dayz%2Fjekyll-themes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29149594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T02:39:25.012Z","status":"ssl_error","status_checked_at":"2026-02-06T02:37:22.784Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["demo-site","jamstack","jekyll","jekyll-themes","ruby-gem","theme-gem","themes","web-development","webdev"],"created_at":"2024-09-28T02:42:31.353Z","updated_at":"2026-02-06T04:03:01.052Z","avatar_url":"https://github.com/benjammin4dayz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flow\n\n`Flow` is a simple and elegant SPA-inspired Jekyll theme for your client or portfolio. This mobile-friendly design features snap scrolling, lazy loading capability, and more.\n\n## Installation\n\n1. Download [theme scaffold](https://github.com/benjammin4dayz/jekyll-themes/releases?q=Flow)\n\n2. Customize `_config.yml`\n\n3. Upload to GitHub (or build locally)\n\n4. Go to your repository settings tab and enable GitHub Pages via Actions\n\n5. Go to your repository actions tab and trigger the workflow to generate your website\n\n### As a Ruby Gem\n\n#### Note: Replace references to `flow-v0.0.0` with the appropriate version\n\n- Use Bundler\n\n  - Create a Gemfile and paste this\n\n    ```ruby\n    source \"https://rubygems.org\"\n    gem \"jam-flow\", tag: 'flow-v0.0.0', github: 'benjammin4dayz/jekyll-themes'\n    ```\n\n  - Then get the template\n\n        $ bundle install\n        $ bundle exec flow go\n\n- Use [specific_install](https://rubygems.org/gems/specific_install) if you're too lazy to add a Gemfile\n\n      $ gem install specific_install\n      $ gem specific_install -l 'https://github.com/benjammin4dayz/jekyll-themes.git' -t 'flow-v0.0.0'\n\n## Usage\n\n### Add Site Icon (Favicon)\n\n1.  Generate and download your favicon using your preferred method\n    - I suggest [favicon.ico](https://favicon.ico) by [John Sorrentino](https://twitter.com/johnsorrentino)\n2.  Extract your favicon files in `assets/favicon/`\n\n        - _articles/\n        - _includes/\n        - assets/\n          - js/\n          - favicon/\n            - android-chrome-192x192.png\n            - android-chrome-512x512.png\n            - apple-touch-icon.png\n            - favicon.ico\n            - favicon-16x16.png\n            - favicon-32x32.png\n            - site.webmanifest\n\n### Add Portrait:\n\nSpecify a URL or replace the [local portrait](./assets/portrait.jpg) found at `./assets/portrait.jpg`\n\n```yaml\n# _config.yml\nclient:\n  portrait_url: https://example.com/my-photo # Leave blank to use local portrait\n```\n\n### Add Social Links\n\nUnder the `social` namespace, declare each `platform` with its name, and then specify your `handle`. Buttons appear in the order that platforms are listed here.\n\n```yaml\n# _config.yml\nsocial:\n  - platform: Facebook\n    handle: JohnD\n```\n\n[Supported Platforms \u0026 Icons](./_data/social_icons.yml)\n\n### Add New Articles\n\nCreate `n-article.html` in the `_articles` folder, where `n` is the order in which it should appear.\n\n- To include something in the document head, use `_includes/head.html`\n\n```html\n---\ntitle: Page One\nanchor: page-one\n---\n\n\u003csection id=\"example-article\"\u003e\n  \u003cheader\u003e\n    \u003ch1\u003eThis is a page\u003c/h1\u003e\n  \u003c/header\u003e\n  \u003cp\u003eCopy me to create new scrollable pages\u003c/p\u003e\n\u003c/section\u003e\n```\n\n### Add Custom Pages\n\nCreate the HTML document in your project root with the following front matter:\n\n- To include something in the document head, use `_includes/custom-head.html`\n\n```yaml\n---\ntitle: My Custom Page\ndescription: Hello, search engine robots!\nlayout: custom\n---\n```\n\n**Note:** don't worry about `\u003c!DOCTYPE\u003e`, `\u003chead\u003e`, or `\u003cbody\u003e` tags- they are handled for you.\n\n### Basic Lazy Load\n\n```js\nconst whenThisElementIsObserved = 'my-element-id';\nconst forThisAmountOfTime = 100; // ms\nconst thisHappensAsAResult = () =\u003e console.log('Hello, world!');\n\n// Post 'Hello, world' to the console when 'my-element-id' is observed for 100ms\nFlowTheme.lazy(\n  whenThisElementIsObserved,\n  forThisAmountOfTime,\n  thisHappensAsAResult\n);\n```\n\n### Embed Helper\n\n#### YouTube\n\n```js\nconst YouTube = new FlowTheme.EmbedHelper.YouTube(\n  'your-channel-id',\n  'embed-target-id'\n);\nYouTube.fetchVideoData().then((data) =\u003e {\n  const { mostRecentVideo, list } = data;\n  mostRecentVideo.embed();\n  list[i].embed();\n});\n```\n\n#### Twitch\n\nNot implemented yet :(\n\n## Contributing\n\nPlease share any bugs that you encounter on [GitHub](https://github.com/benjammin4dayz/jekyll-themes) or contact me on Discord @benjammin4dayz\n\nThis project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.\n\n## Development\n\nClone the repo\n\n    $ git clone https://github.com/benjammin4dayz/jekyll-themes.git\n    $ git checkout flow-src\n\nGet the distributables and navigate to the output directory\n\n    $ .\\dist\n    $ cd jam-flow\n\nModify the Gemfile to point `flow` to the gem development path instead of the repo\n\n```ruby\ngem \"jam-flow\", path: '../'\n```\n\nCall `bundler exec jekyll serve` using the `serve.rb` alias\n\n    $ .\\serve\n\nWhen the theme is built, only the files specified in ` spec.files` will be bundled.\nTo add a custom directory to the theme-gem, please edit the regexp in `flow.gemspec` accordingly.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjammin4dayz%2Fjekyll-themes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenjammin4dayz%2Fjekyll-themes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjammin4dayz%2Fjekyll-themes/lists"}