Dasein

An Astro starter for personal blogs and portfolios with TypeScript, Tailwind CSS, Pagefind search, and theming.

Features

• Blog with Markdown/MDX, featured post, and tag listings
• Typed collections for posts, authors, and socials in src/content.config.ts
• Site-wide search via Pagefind with an accessible modal
• SEO-ready: OpenGraph/Twitter, canonical links, and preloaded fonts in src/components/BaseHead.astro
• Themes light/dark with persistent toggle; debug toggle for layout borders
• RSS (/rss.xml) and sitemap (/sitemap-index.xml) generated automatically

Requirements

• Bun
• Astro@latest
• Tailwdind CSS

Install & run

# install dependencies
bun install

# start dev server
bun run dev

# production build
bun run build

# preview the build
bun run preview

Content

• Posts: add .md or .mdx under src/content/blog. Schema validates title, description, pubDate, updatedDate?, heroImage?, tags[].
• Authors: src/content/authors.yml.
• Socials: src/content/socials.yml.

Frontmatter example:

---
title: "How we launch in 6 weeks"
description: "End-to-end process for small teams."
pubDate: 2024-12-12
updatedDate: 2025-01-03
tags: [delivery, process]
heroImage: ../../assets/blog/ship.jpg
---

Quick customization

• Site name and description in src/consts.ts.
• Navigation and hero actions in src/pages/index.astro.
• Colors, type, and utilities in src/styles/global.css.
• Key components: header with search and toggles (src/components/Header.astro), base layout (src/layouts/BaseLayout.astro).

Available scripts

• npm run dev: server on localhost:4321 (Astro default).
• npm run build: outputs dist/ ready to deploy.
• npm run preview: serves the built site locally.

Deploy

Output is static HTML. Upload dist/ to your platform of choice (Netlify, Vercel, Cloudflare Pages, S3+CDN). Set BASE_URL if you publish under a subpath.