Astro Biolink Kit

Astro Biolink Kit is a starter template for building a self-hosted, single-page link-in-bio site using the Astro static site generator, designed as an open-source alternative to Linktree.

What is Astro Biolink Kit?

Astro Biolink Kit is an open-source GitHub project by Leif Jerami that provides a minimal Astro website for sharing multiple links from one URL. It takes a Markdown file (src/pages/bio.md) as its content source and produces a static HTML page styled by a global CSS file. The template runs on Astro (currently using the classic src/pages structure) and can be developed locally with npm install and npm run dev. The live demo is hosted at biolink-kit.pages.dev, showing a typical deployment on Cloudflare Pages.

Key Features

• Astro-based — Built with Astro, so the final output is a set of static HTML files with no server-side dependencies.
• Markdown-driven content — All the links live in src/pages/bio.md, meaning edits are as simple as rewriting a text file.
• Minimal folder structure — The repo contains only public/, src/layouts/Layout.astro, src/pages/index.astro plus bio.md, and src/styles/global.css, making it easy to understand and adapt.
• Global styling — Centralized CSS in src/styles/global.css allows you to change the look and feel without touching component markup.
• Deployment-ready — The included package.json and standard npm scripts let you build and publish to any static host; the author's demo runs on Cloudflare Pages.
• Self-hosted alternative — Unlike hosted services, you own the code and can deploy it on your own domain, keeping full control over content and branding.
• Open-source — The repository is publicly available on GitHub under the account leifjerami, with clear instructions for cloning and running.

Who should use Astro Biolink Kit?

• Developers — who want a code-focused link-in-bio page they can customize, version-control, and integrate into an existing Astro or static site workflow.
• Content creators and influencers — who need a simple, fast page to list their social profiles, YouTube channels, or merch store links and prefer editing a Markdown file over a drag-and-drop CMS.
• Self-hosting enthusiasts — who want to move away from third-party link-in-bio services and host a free, open-source solution on their own infrastructure.

Use cases

• Personal bio pages: Set up a central link page for your social media handles, email, portfolio, and resume, then share it from Instagram, Twitter, or LinkedIn.
• Project or business links: Use the template as a single link for a side project, pointing visitors to your product, documentation, and contact form.
• Event landing link: Quickly spin up a page with multiple links for an event — tickets, schedule, venue map — without paying for a dedicated landing page tool.

How does the template work?

After cloning the repository, run npm install to install dependencies and npm run dev to preview the site locally. Open src/pages/bio.md, replace the example links with your own, and save the file — the page updates immediately. When you are ready, build the static site with npm run build and deploy the output to any hosting service; the author demonstrates Cloudflare Pages.

Pricing

The template is free and open-source. You can clone the repository, use it for personal or commercial projects, and modify it as needed. There are no paid tiers or license restrictions mentioned in the repository.

Alternatives

• Linktree — a hosted, commercial link-in-bio service with paid plans for additional features.
• Carrd — a multi-purpose single-page site builder that can also create simple link pages.

FAQ

Is Astro Biolink Kit free?

Yes, the template is open-source and freely available on GitHub. You can use it without paying anything, even for commercial purposes.

How do I change the links?

Edit the Markdown file at src/pages/bio.md and replace the example entries with your own link titles and URLs. The Astro dev server will reflect the changes instantly.

Do I need to know Astro to use the template?

You can maintain your links with basic Markdown knowledge. To customize the layout or styling, familiarity with Astro components and CSS is helpful.

Can I deploy this to my own domain?

Yes. Since Astro generates static files, you can host the build output on any web server or static hosting provider, including Cloudflare Pages, Netlify, Vercel, or a personal server.

What is the difference between this and Linktree?

Astro Biolink Kit is a self-hosted, open-source code template that you fully control, while Linktree is a proprietary, hosted service that requires you to use their platform. With this kit, you own the files and can customize everything.