{"id":46566706,"url":"https://github.com/haydenk/lynko","last_synced_at":"2026-03-07T07:12:29.771Z","repository":{"id":341428226,"uuid":"1169723291","full_name":"haydenk/lynko","owner":"haydenk","description":"Hugo module that adds a polished, zero-JS linktree-style /links page to any Hugo site — auto light/dark mode, 25+ SVG icons, and a single CSS variable to theme it.","archived":false,"fork":false,"pushed_at":"2026-03-01T19:11:03.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-03-01T19:35:02.140Z","etag":null,"topics":["css","dark-mode","hugo","hugo-module","hugo-theme","link-page","linktree","no-javascript","static-site","svg-icons"],"latest_commit_sha":null,"homepage":"https://haydenk.github.io/lynko/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/haydenk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"haydenk","patreon":"haydenk"}},"created_at":"2026-03-01T05:24:06.000Z","updated_at":"2026-03-01T19:11:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/haydenk/lynko","commit_stats":null,"previous_names":["haydenk/lynko"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/haydenk/lynko","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haydenk%2Flynko","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haydenk%2Flynko/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haydenk%2Flynko/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haydenk%2Flynko/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haydenk","download_url":"https://codeload.github.com/haydenk/lynko/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haydenk%2Flynko/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30209488,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"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":["css","dark-mode","hugo","hugo-module","hugo-theme","link-page","linktree","no-javascript","static-site","svg-icons"],"created_at":"2026-03-07T07:12:29.274Z","updated_at":"2026-03-07T07:12:29.744Z","avatar_url":"https://github.com/haydenk.png","language":"HTML","readme":"# Lynko\n\nA Hugo **module** (not a standalone theme) that adds a polished, linktree-style\n`/links` page to any existing Hugo site — or works standalone as the whole site.\n\n- Pure CSS3: custom properties, native nesting, `color-scheme`, `light-dark()`,\n  `color-mix()`, `@layer`, backdrop-filter, animations\n- Auto light / dark mode — no JavaScript required\n- 25+ inline SVG brand icons (fill-based, colour-controlled via CSS)\n- Explicit icon selection via config; falls back to a generic link icon\n- Staggered entrance animations\n- Primary colour fully configurable via a single CSS variable\n- Accessible: keyboard navigation, `focus-visible`, `prefers-reduced-motion`\n- Works alongside **any** existing Hugo theme (PaperMod, Congo, Blowfish, etc.)\n- Can also run **standalone** as the entire site\n\n---\n\n## Usage\n\nLynko works in two modes. Choose one, or use both in the same site.\n\n---\n\n### Option A — Add a `/links` page to an existing site\n\nUse this when you already have a Hugo site with a theme and want to add a\nlinktree at `yoursite.com/links/` without touching anything else.\n\n#### 1 · Import the module\n\n```bash\nhugo mod get github.com/haydenk/lynko\n```\n\nThen add to your `hugo.toml`:\n\n```toml\n[module]\n  [[module.imports]]\n    path = \"github.com/haydenk/lynko\"\n```\n\n#### 2 · Create the section page\n\n```bash\nmkdir -p content/links\ncat \u003e content/links/_index.md \u003c\u003c 'EOF'\n+++\ntitle  = \"Links\"\nlayout = \"lynko\"\n+++\nEOF\n```\n\nThe `layout = \"lynko\"` key is required — it tells Hugo to use Lynko's\nself-contained page template. Without it, the section falls through to your\nexisting theme's list layout.\n\nYour linktree is now live at `yoursite.com/links/`.\n\n#### 3 · Configure your links\n\nAdd a `[params.lynko]` block to your `hugo.toml`:\n\n```toml\n[params.lynko]\n  title  = \"Hayden King\"\n  handle = \"@haydenk\"\n  bio    = \"Designer · Developer · Coffee enthusiast\"\n  avatar = \"/images/me.jpg\"        # relative to /static\n\n  # Optional: override the accent colour\n  # primaryColor = \"#0ea5e9\"\n\n  [[params.lynko.links]]\n    title = \"My Blog\"\n    url   = \"https://myblog.example\"\n    icon  = \"globe\"\n\n  [[params.lynko.links]]\n    title = \"GitHub Projects\"\n    url   = \"https://github.com/haydenk\"\n    icon  = \"github\"\n\n  [[params.lynko.links]]\n    title  = \"Say hello\"\n    url    = \"mailto:hi@example.com\"\n    icon   = \"email\"\n    target = \"_self\"\n\n  [[params.lynko.social]]\n    name = \"github\"\n    url  = \"https://github.com/haydenk\"\n\n  [[params.lynko.social]]\n    name = \"twitter\"\n    url  = \"https://x.com/haydenk\"\n```\n\n---\n\n### Option B — Standalone site (homepage is the linktree)\n\nUse this when the linktree *is* the entire site — no other pages, no theme.\n\n#### 1 · Create a new Hugo site\n\n```bash\nhugo new site mylinks\ncd mylinks\nhugo mod init github.com/yourname/mylinks\n```\n\n#### 2 · Import the module\n\n```bash\nhugo mod get github.com/haydenk/lynko\n```\n\nAdd to `hugo.toml`:\n\n```toml\n[module]\n  [[module.imports]]\n    path = \"github.com/haydenk/lynko\"\n```\n\n#### 3 · Set the homepage layout\n\n```bash\ncat \u003e content/_index.md \u003c\u003c 'EOF'\n+++\ntitle  = \"Links\"\nlayout = \"lynko\"\n+++\nEOF\n```\n\n#### 4 · Configure your links\n\nSame `[params.lynko]` block as Option A above.\n\nYour linktree is now live at the root — `yoursite.com/`.\n\n---\n\n### Option C — Both (standalone homepage + `/links` section)\n\nSet `layout = \"lynko\"` on both `content/_index.md` and\n`content/links/_index.md`. Each renders independently from the same\n`[params.lynko]` config.\n\n---\n\n## Configuration reference\n\nAll options live under `[params.lynko]`.\n\n| Key | Type | Default | Description |\n|---|---|---|---|\n| `title` | string | site title | Display name |\n| `handle` | string | — | Subtitle / handle (`@you`) |\n| `bio` | string | site description | Short bio text |\n| `avatar` | string | — | Path to profile image (relative to `/static` or absolute URL) |\n| `primaryColor` | string | `#0ea5e9` | Any valid CSS colour — overrides `--lynko-primary` |\n| `showPoweredBy` | bool | `true` | Show \"Powered by Hugo\" footer |\n| `metaTitle` | string | `\"Name — Links\"` | `\u003ctitle\u003e` override |\n| `metaDesc` | string | bio | `\u003cmeta description\u003e` override |\n\n### `[[params.lynko.links]]`\n\n| Key | Required | Description |\n|---|---|---|\n| `url` | ✓ | Destination URL or `mailto:` |\n| `title` | ✓ | Button label |\n| `icon` | | Icon name (see list below); omit to use the generic `link` icon |\n| `target` | | Link target; defaults to `_blank` |\n| `rel` | | Link rel; defaults to `noopener noreferrer` |\n\n### `[[params.lynko.social]]`\n\n| Key | Required | Description |\n|---|---|---|\n| `name` | ✓ | Icon name (see list below) |\n| `url` | ✓ | Profile URL |\n\n---\n\n## Supported icons\n\n| Name | Platform |\n|---|---|\n| `github` | GitHub |\n| `twitter` | Twitter / X |\n| `linkedin` | LinkedIn |\n| `instagram` | Instagram |\n| `youtube` | YouTube |\n| `tiktok` | TikTok |\n| `facebook` | Facebook |\n| `discord` | Discord |\n| `twitch` | Twitch |\n| `mastodon` | Mastodon |\n| `bluesky` | Bluesky |\n| `reddit` | Reddit |\n| `medium` | Medium |\n| `substack` | Substack |\n| `patreon` | Patreon |\n| `spotify` | Spotify |\n| `soundcloud` | SoundCloud |\n| `pinterest` | Pinterest |\n| `snapchat` | Snapchat |\n| `email` / `mail` | Email |\n| `rss` | RSS feed |\n| `globe` / `website` | Generic website |\n| `link` | Generic link (fallback) |\n\n\n---\n\n## Theming \u0026 CSS customisation\n\nThe only variable you normally need is `primaryColor` in `hugo.toml`.\n\nFor deeper customisation, override any `--lynko-*` custom property in your\nsite's CSS, **outside** the `lynko` layer so it takes precedence:\n\n```css\n/* assets/css/custom.css */\n:root {\n  --lynko-radius-md: 1.5rem;   /* rounder buttons */\n  --lynko-blur: 24px;          /* stronger glass */\n}\n```\n\n---\n\n## Design decisions\n\n- **No JavaScript** — 100% CSS light/dark mode, animations, and hover effects\n- **Self-contained page** — the `lynko` layout renders its own `\u003chtml\u003e` so it\n  never inherits the parent theme's navigation, sidebar, or fonts. This is\n  intentional: a linktree page should look distinct and load fast\n- **Color-mix for tints** — button backgrounds, borders, and glows are all\n  derived from `--lynko-primary` via `color-mix(in srgb, …)` so changing one\n  variable updates the entire colour scheme\n- **Staggered animations** — entrance delays are set as inline CSS custom\n  properties (`--lynko-stagger`) computed in the Hugo template, keeping the CSS\n  clean\n\n---\n\n## Requirements\n\n- Hugo **v0.121.0+** (standard edition is sufficient — no Sass/PostCSS used)\n- Go 1.22+\n\n---\n\n## License\n\nGPL-3.0-only. See [LICENSE](LICENSE).\n","funding_links":["https://github.com/sponsors/haydenk","https://patreon.com/haydenk"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaydenk%2Flynko","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaydenk%2Flynko","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaydenk%2Flynko/lists"}