Miduwind

Miduwind is an open-source, JSON-customizable links page template built with Astro 5 and Tailwind 4, listed on Astro Themes and distributed under the MIT License.

What is Miduwind?

Miduwind is a single-page link-in-bio template that produces a personal landing page with a gradient background, profile photo, username, about text, and a list of highlighted links. It takes a single data.json file as the only content input and renders a fully styled page. The project is authored by Marcos Klender, runs on Astro v5.7 with Tailwind CSS v4.1, and also uses JavaScript and TypeScript. A live demo is hosted at miduwind.netlify.app.

Key Features

• JSON-driven content — Edit the data.json file to change the page language, title, description, favicon (placed in /public), and the entire page gradient background.
• Header and profile — Set your profile photo (also in /public) and username via the header JSON section.
• About section — Add your real name and a short bio in the about JSON section.
• Highlighted links — Each link in the links JSON section can have its own gradient background and logo, making important links stand out.
• Custom footer — Replace the default copyright text and URL through the footer JSON section.
• Official Astro Themes listing — Available for discovery and install from the Astro Themes directory.
• Modern tooling — Built with Astro v5.7 and Tailwind v4.1; requires Node.js v18.17.1 or v20.3.0+ (v19 is not supported).

Who is it for?

• Creators and influencers who want a custom alternative to Linktree without a subscription fee can deploy Miduwind free on any static host.
• Developers who prefer a hackable Astro + Tailwind starter can fork the repo and extend the JSON schema, since the entire content model is plain data.
• Students of midudev's Tailwind course can use this template as a practical example of building a real project with Astro and Tailwind 4.

What can you do with it?

• Create a personal links hub — Add your social profiles, portfolio, or project links as entries in the links section, each with its own gradient and logo.
• Rebrand the entire page without code — Change title, meta description, favicon, and background gradient purely through JSON, so non-developers can maintain it.
• Deploy to free static hosting — The build output is a static site (the author hosts the demo on Netlify), so you can push it to Netlify, Vercel, or GitHub Pages.

How does Miduwind work?

Clone the repository, install dependencies with pnpm install, and run pnpm dev to start the Astro development server. After that, edit data.json — the html section controls document settings, header sets the photo and username, about holds the bio, links defines the link entries with gradient and logo options, and footer sets the copyright and URL. The changes render in the browser immediately thanks to the Astro dev server.

Pricing

Miduwind is free. The README states you can create your very own links page for FREE, and the source is distributed under the MIT License, so there are no paid tiers or subscription requirements.

Alternatives

• AstroLinkHub — The author's earlier Astro-based links page project, which Miduwind describes as a predecessor it improves upon.
• Linktree — A commercial link-in-bio service that Miduwind serves as an open-source, self-hosted alternative with a single JSON file as the content source.

FAQ

Is Miduwind free?

Yes. The README explicitly says you can create your very own links page for FREE, and the project is released under the MIT License, allowing free use, modification, and distribution.

What does Miduwind do?

Miduwind is an open-source links page template built with Astro 5 and Tailwind 4. It turns a single data.json file into a styled personal landing page with a profile header, about section, and customizable link buttons with gradients and logos.

What Node.js version do I need to run Miduwind?

Node.js v18.17.1 or v20.3.0 or higher is required; Node.js v19 is not supported. The project also recommends Visual Studio Code with the official Astro extension for development.

How do I customize my links in Miduwind?

Open the data.json file in the repository root. In the links section, each link entry can specify a URL, label, gradient background, and logo. Add, remove, or reorder entries in that JSON array, and the page updates.

Is Miduwind available on Astro Themes?

Yes, Miduwind is listed in the official Astro Themes directory at astro.build/themes/details/miduwind/, which is also where you can preview it.