{"id":13929449,"url":"https://github.com/kdevo/osprey-delight","last_synced_at":"2026-01-23T01:55:07.469Z","repository":{"id":40577512,"uuid":"223589504","full_name":"kdevo/osprey-delight","owner":"kdevo","description":"Osprey Delight is the free-minded artist's choice for a clutter-free and blazingly fast single-page portfolio.","archived":false,"fork":false,"pushed_at":"2025-02-07T05:13:02.000Z","size":5208,"stargazers_count":106,"open_issues_count":1,"forks_count":47,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-07T06:20:48.165Z","etag":null,"topics":["contact-form","developer-portfolio","fast","gallery","homepage","hugo","hugo-mods","hugo-theme","lazy-loading","lqip","minimalistic","pagespeed-insights","personal","personal-site","portfolio"],"latest_commit_sha":null,"homepage":"https://hugo-mods.github.io/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kdevo.png","metadata":{"files":{"readme":"README.md","changelog":"history.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","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":["kdevo"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":[]}},"created_at":"2019-11-23T13:03:41.000Z","updated_at":"2025-02-07T05:13:06.000Z","dependencies_parsed_at":"2024-06-18T21:20:20.767Z","dependency_job_id":"8ec15b05-45f3-4718-bacb-723401f8e390","html_url":"https://github.com/kdevo/osprey-delight","commit_stats":{"total_commits":282,"total_committers":20,"mean_commits":14.1,"dds":0.5354609929078014,"last_synced_commit":"daf278c0564f20b0e23cdd41643f3863d2935627"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/kdevo/osprey-delight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdevo%2Fosprey-delight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdevo%2Fosprey-delight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdevo%2Fosprey-delight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdevo%2Fosprey-delight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdevo","download_url":"https://codeload.github.com/kdevo/osprey-delight/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdevo%2Fosprey-delight/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28677714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T01:00:35.747Z","status":"ssl_error","status_checked_at":"2026-01-23T01:00:19.529Z","response_time":144,"last_error":"SSL_read: 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":["contact-form","developer-portfolio","fast","gallery","homepage","hugo","hugo-mods","hugo-theme","lazy-loading","lqip","minimalistic","pagespeed-insights","personal","personal-site","portfolio"],"created_at":"2024-08-07T18:02:21.286Z","updated_at":"2026-01-23T01:55:07.453Z","avatar_url":"https://github.com/kdevo.png","language":"SCSS","funding_links":["https://github.com/sponsors/kdevo"],"categories":["others"],"sub_categories":[],"readme":"\u003ca href=\"https://git.io/osprey-delight\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Osprey Delight Logo\" src=\"https://raw.githubusercontent.com/kdevo/osprey-delight/master/images/osprey-delight-logo.png\" width=\"250\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://kdevo.netlify.app/\" target=\"_blank\"\u003e\n    \u003cimg align=\"right\" alt=\"Nelify Continous Deployment Status\" src=\"https://api.netlify.com/api/v1/badges/aff9a674-45e1-4437-89f7-2aabb281780f/deploy-status\"\u003e\n\u003c/a\u003e\n\n---\n\n[![GitHub Release](https://img.shields.io/github/v/release/kdevo/osprey-delight?style=flat-square\u0026color=%230097a7\u0026logo=github)](https://github.com/kdevo/osprey-delight/releases/latest)\n[![Discussions](https://img.shields.io/badge/GitHub-Discussions-%230097a7?logo=github\u0026style=flat-square)](https://github.com/kdevo/osprey-delight/discussions)\n[![Hugo Minimum Version](https://img.shields.io/badge/hugo-%3E=v0.120-%230097a7?logo=hugo\u0026style=flat-square)](https://github.com/gohugoio/hugo/releases)\n[![Built with hugo-mods](https://img.shields.io/static/v1?label=%E2%9D%A4\u0026message=hugo-mods\u0026color=0097a7\u0026style=flat-square)](https://github.com/hugo-mods)\n\n## Overview\n\nOsprey Delight is the free-minded artist's choice for a clutter-free and blazingly fast single-page portfolio.\n\nIt's perfectly suited to show off your awesome work!\n\n\u003e It originates from [the great Osprey theme](https://github.com/tomanistor/osprey) by [Toma Nistor](https://github.com/tomanistor) and adds new optimizations and features to your **delight**.\n\n### ⚠️ Life support\n\nDue to Hugo's way of moving forward with breaking their API regularly [[1]](https://github.com/kdevo/osprey-delight/issues/48) [[2]](https://github.com/kdevo/osprey-delight/issues/58) [[3]](https://commaok.xyz/post/on_hugo/) [...](https://news.ycombinator.com/item?id=41822449), this project is an ongoing maintenance effort.\nIf you want this theme to continue to live and also be supported in newer Hugo versions, please consider to [sponsor it](https://github.com/sponsors/kdevo).\n\nIf that's not possible for you, there are other ways to show your support:\n\n- ⭐ Give the project a star\n- Start [contributing](https://github.com/kdevo/osprey-delight/blob/master/CONTRIBUTING.md)\n\n### Showcase\n\nCheck out how Osprey Delight performs in the real-world:\n\n- [Hugo Mods](https://hugo-mods.github.io/) - This theme is built around the Hugo Mods presented on the site. This site also has the [complete source code available](https://github.com/hugo-mods/hugo-mods.github.io).\n- [KDEVO](https://kdevo.github.io/) - It wouldn't be me if I would not run this theme personally to ensure that everything runs smoothly.\n\n### Features\n\n- Modular and made out of extensible section building blocks:\n  - About: Introduce yourself\n  - Gallery: Show your work using a grid-based gallery with interactive modal boxes\n  - Blog: Lightweight blog features\n  - Contact: Contact form with Basin support and built-in spambot protection\n- Use your high-quality images [assets](https://gohugo.io/categories/asset-management):\n  - Lazy image loading plus completely automatic resizing using [lazyimg](https://github.com/hugo-mods/lazyimg) module\n  - Blur-up technique using automatic low-quality image placeholders (LQIP)\n  - Modern WebP support with fallback for older browsers\n- SEO:\n  - [Score 100 at PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fkdevo.github.io%2F). Every bit is fine-tuned with performance in mind!\n  - Auto-generated structured ensures that everyone finds you\n- Delightful UX:\n  - Choose between different themes\n  - Awesome social icons in footer via [icons module](https://github.com/hugo-mods/icons)\n  - Smooth scrolling plus scroll-spy\n  - Automatically fetches GitHub repo data\n  - Sane fallbacks for No-Script/No-JS users\n- Heavily [customizable](#customize-it) - no need to maintain a fork!\n\nIn general, many [open issues](https://github.com/tomanistor/osprey/issues) of the original theme have been resolved and code has been rewritten.\n\n## Quickstart\n\n\u003e Please make sure to have [Hugo's extended version](https://github.com/gohugoio/hugo/releases) and [Go](https://go.dev/) installed.\n\u003e If you're new to Hugo, [visit the docs](https://gohugo.io/getting-started/quick-start/) for more info and general site setup.\n\nInitialize your repo as a module (replace `\u003cusername\u003e` and `\u003cprojectname\u003e` with your GitHub repo):\n\n```sh\nhugo mod init github.com/\u003cusername\u003e/\u003cprojectname\u003e\n```\n\nDownload the [documented config file](https://github.com/kdevo/osprey-delight/blob/master/exampleSite/config.yaml), e.g. via curl:\n\n```sh\ncurl https://raw.githubusercontent.com/kdevo/osprey-delight/master/exampleSite/config.yaml -O\n```\n\nContinue reading for [configuration options](#config).\n\n### Upgrade\n\nReceive the latest features of the theme:\n\n```\nhugo mod get -u\n```\n\n\u003e It is good practice to [check the release notes](https://github.com/kdevo/osprey-delight/releases) before upgrading.\n\n## Configuration and Usage \u003ca href=\"config\"\u003e\u003c/a\u003e\n\nIt's best if you simply check out the fully commented [config file](https://github.com/kdevo/osprey-delight/blob/master/exampleSite/config.yaml).\nThis theme follows a learning-by-doing approach.\n\n### Images\n\nThis theme is asset-driven! It \"knows\" how to handle your precious assets, and there usually is no need for manual resizing.\nFor that to work, provide all of the following images in the [`assets` directory](https://gohugo.io/hugo-pipes/introduction/#asset-directory) (do not use the `static` directory).\n\nThe following table shows recommendations regarding the required assets:\n\n| Image Type  | Config Key                   | Minimum Width | Note                                                                                |\n| ----------- | ---------------------------- | ------------- | ----------------------------------------------------------------------------------- |\n| Logo        | `logoBig` (config.yaml)      | 200px         | Transparent, minimum margin top/bottom                                              |\n| Navbar-Logo | `logoSmall` (config.yaml)    | 96px          | Transparent, small margin top/bottom, prefer square format                          |\n| Gallery     | `image` (content/gallery/\\*) | 400px         | Transparent, medium margin top/bottom/left/right, prefer square or landscape format |\n| Background  | `background` (config.yaml)   | 1920px        | Optional, use a high-quality JPG                                                    |\n\n### Content files\n\n#### About section\n\nTo create an about section that renders on the home page, run:\n\n```console\nhugo new about.md\n```\n\n#### Gallery item\n\nTo create a new gallery item, run:\n\n```console\nhugo new gallery/my-item.md\n```\n\nYou will get a fully documented file, which describes each config option separately.\n\n### Contact form\n\nBasin is a free AJAX contact form service that is used by this theme.\n\nTo set it up:\n\n1. [Sign up for a free account](https://usebasin.com/users/sign_up) and create a form.\n2. Copy and paste your form's URL endpoint to the `ajaxBasin` config.yaml parameter.\n3. Select the `Submit this form via AJAX` option on your Basin dashboard.\n\n![Basin AJAX setup](https://raw.githubusercontent.com/kdevo/osprey-delight/master/images/basin-ajax-setup.png)\n\n#### Enable spambot protection\n\nUnder \"Setup\" → \"Set a Custom Honeypot Field\", input `_anti_spam_honeypot`.\nBasin will [ignore all messages that contain this specific field](https://usebasin.com/docs/features/spam-filtering). This should work since there is a hidden field that users normally do not use, but spambots will blindly input their data.\n\n![Basin Anti Spambot](https://raw.githubusercontent.com/kdevo/osprey-delight/master/images/basin-custom-honeypot.png)\n\n[Please do not make a tick in the \"reCAPTCHA\" checkbox](https://github.com/kdevo/osprey-delight/discussions/22), this service is not supported and also typically not necessary.\n\n## Learn more\n\n### Customize it \u003ca href=\"customize-it\"\u003e\u003c/a\u003e\n\nWant to have full control over appearance? Check out [how to customize the theme more granularly](https://github.com/kdevo/osprey-delight/blob/master/CUSTOMIZING.md).\n\n### Need help?\n\nThis theme has a GitHub-powered [community forum](https://github.com/kdevo/osprey-delight/discussions)!\nFeel free to ask questions in the [Q\u0026A](https://github.com/kdevo/osprey-delight/discussions/categories/q-a) (please make sure to completely read the docs and existing discussions/questions).\n\n### Help wanted\n\nThis README probably needs some documentation improvements for the latest features.\nAny PR regarding this is welcome. Please also check out [how to contribute](https://github.com/kdevo/osprey-delight/blob/master/CONTRIBUTING.md)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdevo%2Fosprey-delight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdevo%2Fosprey-delight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdevo%2Fosprey-delight/lists"}