Configure name, bio, avatar, tags, links, and SEO through a single profile.config.ts file, with no need to write HTML or CSS
AstroPortfolio
card — Astro Portfolio Template
By buestro
A themeable personal profile card page built with Astro that generates a static site by editing a single configuration file; the free version is under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-13View source
What stands out
A quick read of the recorded project description.
Includes the Dark Mint theme, with dark/light mode automatically switching following the operating system
Includes 12 social platform icons without relying on an external icon library
The free version contains no client-side JavaScript and outputs static pages generated by Astro
Written in TypeScript strict mode and validates configuration content with Zod
The README provides customization and deploy documents, covering configuration reference and deployment steps for three hosting platforms
Template Details
Buestro Card is a personal profile page template built with Astro, positioned as a themeable personal business-card-style page. Its core idea is to separate content from structure: users only need to edit a single configuration file, src/config/profile.config.ts, filling in name, handle, bio, avatar, tags, links, and SEO settings, without writing HTML or CSS. The template includes the Dark Mint theme and automatically switches between dark and light mode following the operating system, and it includes 12 social platform icons without relying on an additional icon library.
Technically, the project uses Astro as the static site generator, with Tailwind CSS for styling, TypeScript written in strict mode, and Zod for validating the configuration. The free version contains no client-side JavaScript. The repository provides two documents, customization and deploy, explaining the meaning of configuration options and the steps to deploy to Vercel, Netlify, and Cloudflare Pages, respectively.
Note that the Pro version mentioned in the README includes 5 additional themes, a QR code, vCard download, a persistent dark/light toggle, and dynamic OG images; these features are not part of the free code included here. Third-party assets such as images, fonts, and icons in the demo page must be checked separately under their respective licenses.
AstroPortfolio
Is it right for your project?
Use Cases
- Individual developers or designers building a concise online personal business-card page
- Centralizing social accounts, a personal bio, and links into a single shareable URL
- Serving as a starting project for practicing Astro static site deployment
- A lightweight personal page that needs to follow the system dark/light mode and does not introduce client-side scripts
Suitable For
- Users who want to launch a personal profile page by changing only one configuration file
- Front-end developers using Astro or willing to run npm commands according to the documentation
- Developers who need an MIT-licensed template usable for personal or commercial purposes
- Users planning to deploy to Vercel, Netlify, or Cloudflare Pages
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, run npm install, then edit src/config/profile.config.ts to fill in personal information
- 2
Run npm run dev locally; the default access address is http://localhost:4321
- 3
For configuration options, refer to docs/customization.md; for deployment steps, refer to docs/deploy.md
- 4
The README mentions that the Pro version includes additional themes, a QR code, vCard download, persistent theme switching, and dynamic OG images; these are not included in the free code
- 5
Third-party assets such as demo images, fonts, and icons must be checked under their respective licenses and cannot be judged solely by the code's MIT license
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The project materials mention an optional paid version or features; this entry only covers the public free code and does not include paid upgrades.
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
- The Pro version additionally provides 5 themes, a QR code, vCard download, a persistent dark/light toggle, and dynamic OG images; these features are not part of the free code scope and require a paid upgrade to use.
- The free version does not include client-side JavaScript; if features that rely on client-side scripts are needed, they belong to the Pro version and are not within the free scope.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
The Pro version adds 5 additional themes, QR code, vCard download, persistent dark/light toggle, and dynamic OG images.
Original README
https://github.com/buestro/card/blob/main/LICENSEhttps://github.com/buestro/card/blob/main/README.mdZero client-side JavaScript in the free version
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-13. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 80 / 100
- Technologies
- Astro
- Website type
- Portfolio
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-05-13
- Screenshot last checked
- 2026-10-13
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: codex-user-requested-batch-review-20261015 · 2026-10-15
Inspect the recorded source material
SHA-256: c815b43816438a1115dbaf072af9560e9767e1e101d9ae0a6a65bb222cb07319
2026-10-13T00:56:41.439Z
Source file / repository# Buestro Card  A beautiful, themeable personal profile page. Edit one config file, deploy anywhere. **[Live demo](https://card.buestro.com)** · [Get Pro](https://buestro.com/card) · [Docs](./docs/customization.md)      --- ## Features - Edit a single `profile.config.ts` — no HTML, no CSS required - Dark Mint theme with automatic dark/light mode (follows OS) - 12 social platform icons built in (no icon library needed) - Optimized for Performance, Accessibility, and SEO - Zero client-side JavaScript in the free version - Deploys in minutes to Vercel, Netlify, or Cloudflare Pages - MIT licensed — free for personal and commercial use ## Quick start ```bash # 1. Clone and install git clone https://github.com/buestro/card.git my-card cd my-card npm install # 2. Edit your profile # Open src/config/profile.config.ts and fill in your info # 3. Run locally npm run dev ``` Your card will be live at `http://localhost:4321`. ## Customization See [docs/customization.md](./docs/customization.md) for a full reference on changing your name, handle, bio, avatar, tags, links, and SEO settings. ## Preview  ## Deploy See [docs/deploy.md](./docs/deploy.md) for step-by-step guides for Vercel, Netlify, and Cloudflare Pages. ## Tech stack - [Astro 5](https://astro.build) — static site generator - [Tailwind CSS 4](https://tailwindcss.com) — utility-first CSS - [TypeScript](https://typescriptlang.org) — strict mode - [Zod](https://zod.dev) — config validation ## Pro version The Pro version adds 5 additional themes, QR code, vCard download, persistent dark/light toggle, and dynamic OG images. [Upgrade to Pro →](https://buestro.com/card) ## License MIT © [Buestro](https://buestro.com)
Explore similar templates
Compare previews and descriptions within the same stack and category.
astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio
astro-nano
Astro Nano is a static, minimalist portfolio and blog template built with Astro, Tailwind, and TypeScript without frontend frameworks. It includes light/dark themes, animated UI, automatic sitemap and RSS feed generation, and Markdown/MDX support with component imports.
Astro · Portfolio
astro-erudite
astro-erudite is an opinionated, unstyled static blog template built with Astro and native CSS, with no UI or CSS framework and minimal dependencies.
Astro · Portfolio
astro-sphere
Astro Sphere is a static, minimalist portfolio and blog theme maintained by markhorn-dev, built mainly with Astro, Tailwind, and TypeScript, with a small amount of SolidJS for stateful components.
Astro · Portfolio
astro-micro
Astro Micro is a framework-free blog and portfolio theme for Astro, forked from Astro Nano. It adds Pagefind search and Giscus comments while retaining type safety, sitemap, RSS, Markdown and MDX support, and TailwindCSS with system, light, and dark themes.
Astro · Portfolio
astro-aria
astro-aria is an Astro-based personal blog and portfolio template maintained by miantiao-me, ported from static-templates/aria.
Astro · Portfolio