English | 繁體中文

linkyee — Your Own Link Page

A fully customized, 100% free, open-source LinkTree alternative — deployed straight to GitHub Pages.

Inspired by Jekyllrb and LinkTree.

Live Demo →

In one sentence: click Use this template, edit one YAML file, push — your link page is live on GitHub Pages with a free *.github.io domain (or your own). No SaaS, no monthly fee, no vendor lock-in. AI-assisted theming and plugin development included.

Table of contents

• Why linkyee?
• Configuration
• Themes 🎨
• Plugins 🔌
• Get Started – Deploy on GitHub Pages
• Local testing
• Custom Domain
• Showcase ✨
• Donate

Why linkyee?

• 100% free. Hosted on GitHub Pages. No subscriptions, no ads, no upsells.
• 100% yours. Your config, themes, plugins, and content live in your own GitHub repo. Take it offline whenever you want.
• 8 ready-made themes — switch by editing a single line in config.yml.
• AI Style Designer. Describe the look you want in plain English; the bundled linkyee-style-designer Claude skill writes the full theme for you (HTML + CSS + JS).
• 6 built-in plugins for live data — GitHub stars, last commit, profile stats, RSS/Atom feeds, date countdowns, latest YouTube video.
• AI Plugin Builder. Want data from somewhere else? Describe the source; the bundled linkyee-plugin-builder skill writes the Ruby plugin and wires it in.
• SEO + accessibility built-in. WCAG AA contrast, dark mode, responsive down to 320 px, OG/Twitter meta, keyboard-friendly focus states.
• Local preview with auto-rebuild. ./preview.sh rebuilds on save; refresh the browser, no plugins needed.

Buy me a beer ❤️❤️❤️

If this project has helped you, feel free to sponsor me a cup of coffee, thank you.

Feel free to open an issue or submit a fix/contribution via pull request. :)

Configuration

Everything that ends up on your page is driven by a single file: config.yml. It's a Liquid-rendered YAML file with five top-level sections:

theme: default                     # ← directory under ./themes/
lang: "en"

plugins:                           # ← optional dynamic data fetched at build time
  - GithubRepoStarsCountPlugin: [ZhgChgLi/linkyee]

title: "Your Name"                 # ← profile header
avatar: "./images/profile.jpeg"
name: "@yourhandle"
tagline: "One line about you."

links:                             # ← buttons in the link list
  - link:
      icon: "fa-brands fa-github"
      text: "GitHub ({{ vars.GithubRepoStarsCountPlugin['ZhgChgLi/linkyee'] }} ⭐)"
      url: "https://github.com/yourname"
      target: "_blank"

socials: [ ... ]                   # ← icon-only social row
footer: "Free-form HTML."
copyright: "© 2026 You."

The shipped config.yml is a fully working example that exercises every built-in plugin — read it as the canonical reference. Edit fields in place, push, wait for GitHub Actions to rebuild, refresh.

Automatic redeployment

The site rebuilds automatically once a day so plugin output (star counts, latest posts, etc.) stays fresh. The cron lives in build.yml:

schedule:
    - cron: '0 0 * * *'   # daily at 00:00 UTC

Delete the schedule: block if you don't want scheduled redeploys.

Themes 🎨

linkyee ships 8 built-in themes designed to be drop-in usable. Switch by editing one line in config.yml:

theme: minimal-mono   # any directory under ./themes/

Every built-in theme meets the same baseline: WCAG AA contrast, dark mode that auto-switches with your system appearance (no manual toggle), responsive down to 320 px, keyboard-accessible focus states, and prefers-reduced-motion support.

To try them locally before committing, see Local testing. To regenerate the preview screenshots above after any visual change, run ./scripts/screenshot-themes.sh (requires npx playwright).

Modifying a theme by hand

Each theme lives at ./themes/<theme-name>/ with three files:

• index.html — Liquid template (consumes config.yml)
• styles.css — the look
• scripts.js — can be empty, but the file must exist

The default theme self-hosts Font Awesome under themes/default/fontawesome/. The other built-ins load Font Awesome from a CDN to keep theme directories small.

🤖 AI Style Designer — generate a theme by description

Don't see a vibe you like? Describe it in plain English and the bundled linkyee-style-designer Claude skill writes a full theme for you.

How to use it:

1. Install Claude Code and open this repo with it.

2. Ask in natural language. Examples:

   "Design a linkyee theme inspired by 1960s Penguin paperback covers."

   "Make my links look like a Japanese ryokan website — quiet, elegant, lots of negative space."

   "I want a vaporwave aesthetic but keep it accessible."

3. The skill reads your config.yml, asks clarifying questions if the brief is vague, generates themes/<your-theme>/, switches theme: in config.yml, and runs the build.

4. Run ./preview.sh <new-theme> to see the result locally.

The skill enforces the same quality bar as the built-in themes: no AI slop (no unwarranted purple-pink gradients, no emoji-as-icons, no centered-everything-no-hierarchy), real typographic hierarchy, accessibility minimums, and strict RWD — mobile-first, ≥44 px tap targets, no horizontal scroll at 320 px.

Deeper design tooling. If you want a richer designer experience (multi-direction exploration, expert review, animation export), install the upstream huashu-design skill alongside it. The linkyee skill defers to huashu-design when both are present.

Plugins 🔌

Plugins are tiny Ruby classes that fetch data at build time and inject it into your page. Use them to render live values inside any link, the tagline, or the footer — anything that's a Liquid string.

Built-in plugins