Home

StarryBio is a static, configurable link-in-bio site built with Astro. You edit one TypeScript configuration file, build one portable dist/ artifact, and deploy it to GitHub Pages, Cloudflare Workers, Vercel, Netlify, or another static host.

It is a good fit for a personal profile, creator hub, or concise landing page that should be fast and inexpensive to operate. It is not a hosted multi-user service: each installation publishes one profile page, and there is no built-in sign-in, admin dashboard, database, or server-side content editor.

Start here

1. New to StarryBio? Read Getting Started to run the starter site and replace its placeholder content.
2. Ready to publish? Read Deployment Overview, then choose GitHub Pages, Cloudflare, Vercel, or Netlify.
3. Already operating an instance? Use Operations and Updates for safe changes, releases, rollback, and recovery guidance.

Configure the site

• Configuration Reference — every supported setting, required fields, and defaults.
• Managing Content — profile, sections, links, featured cards, icons, and time-limited content.
• Appearance and Branding — themes, layouts, motion, and footer branding.
• Availability and Announcements — visitor-local schedules, status badges, and dismissible notices.
• Assets and Generated Downloads — images, Simple Icons, Open Graph cards, QR codes, and vCards.
• SEO and Analytics — metadata and supported analytics providers.

Deploy and operate

• Deployment Overview — portable build contract, shared behavior, and future-host guidance.
• Deploying to Cloudflare — Wrangler static assets and backwards-compatible CLI deployment.
• Deploying to GitHub Pages — GitHub Actions, Pages paths, and custom domains.
• Deploying to Vercel — Git import, static build settings, headers, 404, and domains.
• Deploying to Netlify — Git import, static build settings, headers, 404, and domains.
• Domains and DNS — canonical URLs and provider-specific custom-domain paths.
• Operations and Updates — safe changes and recovery.
• Security and Privacy — what is public, headers and CSP, analytics, and safe change practices.
• Troubleshooting — configuration, builds, deployments, domains, assets, and runtime symptoms.
• FAQ and Limitations — intentionally unsupported functionality and quick answers.

Modify StarryBio

The following pages are for people changing the project itself rather than merely configuring a site:

• Development Setup
• Architecture and Customization
• Testing and Contributing

The operating model

config/starrybio.config.ts + public/ assets
                 │
                 ├─ validation, generated assets, Simple Icons
                 ▼
             Astro build → portable dist/
                              │
       ┌──────────────┬──────────────┬──────────────┬──────────────┐
       ▼              ▼              ▼              ▼
 GitHub Pages  Cloudflare Workers   Vercel        Netlify

StarryBio does not require D1, KV, R2, a database, provider functions, runtime environment variables, or a server entry point. See Deployment Overview for the implications of that design.