Tiny Dev House Website

This is the source for tinydevhouse.com, where we keep project descriptions, building notes, lessons learned, and the occasional waffling.

The site is an Astro static site with Markdown/MDX content, a project archive, dark mode, Pagefind search, RSS, sitemap output, Open Graph metadata, and a small configuration surface for the parts that should be easy to personalize.

About Tiny Dev House

Tiny Dev House is an indie software studio focused on data ownership and thoughtful applications that use interesting machine learning concepts to create value from data locally.

What Is Here

• src/pages/ contains the main routes.
• src/content/blog/ contains blog posts.
• src/content/projects/ contains project pages.
• src/content/micros/ contains short-form notes.
• src/components/ contains shared UI.
• src/styles/ contains design tokens, page styles, prose styles, and component CSS.
• astro-theme-config.ts is the main place for site title, navigation, social links, comments, and About page copy.

Requirements

• Node.js 24.15.0 or newer.
• pnpm. The expected version is pinned in package.json.

Local Development

pnpm install
pnpm dev

The dev server usually starts at http://localhost:4321.

Common Commands

Command	Action
pnpm dev	Start the local dev server
pnpm check	Run Astro type checks
pnpm build	Build the site and generate the Pagefind index
pnpm preview	Preview the production build
pnpm lint	Run ESLint
pnpm lint:css	Run Stylelint
pnpm format	Format source files with Prettier

Writing Content

Create posts in src/content/blog/ and projects in src/content/projects/. The filename becomes the URL slug.

Images that belong to content can live in src/assets/, then be imported or referenced from Markdown frontmatter depending on the page layout.

Configuration

astro-theme-config.ts is the single source for site URL, title, navigation, social links, comment settings, and About page copy.

If you deploy under a subpath, set site.base there. If you deploy at a domain root, keep it empty. Every internal link and asset URL must go through withBase() from src/utils/paths so subpath deployments keep working.

Shipping Tiny Dev House

The production site is deployed by Netlify. Every push to main triggers a new build.

Before pushing:

pnpm check
pnpm build

Then commit and push:

git status
git add .
git commit -m "Describe the change"
git push origin main

Netlify settings:

Setting	Value
Build command	pnpm build
Output directory	dist
Node version	24.15.0 or newer