an Astro starter template for understated personal websites

Built with:

• SolidJS
• MDX, Remark and Unified
• Shiki Twoslash
• Tailwind CSS
• Vercel and Vercel OG
• GitHub Actions

1. Click Use this template to create a new repo.
2. Set VERCEL_TOKEN, VERCEL_PROJECT_ID, and VERCEL_ORG_ID secrets to deploy to Vercel from GHA (enables access to git history).
3. Add OG_IMAGE_SECRET to secure your OG image endpoint.

See full usage instructions.

Inside of your Astro project, you'll see the following folders and files:

├── public/ — static assets
├── posts/
│   └── rebuilding-a-blog.mdx — posts written in MDX
├── src/
│   ├── build-time/* — remark plugins
│   ├── global-styles/* — fonts, body and prose styles
│   ├── layouts/
│   │   ├── BaseLayout.astro — UI shared between all pages
│   │   └── PostLayout.astro — layout for all posts
│   ├── lib/* — reusable utils and UI components
│   ├── pages/
│   │   ├── [path].astro — Astro dynamic route for posts, supplies MDX components
│   │   └── index.astro — index page, lists all posts
│   ├── env.d.ts
│   └── types.ts
├── astro.config.ts
├── package.json
├── postcss.config.cjs
├── tailwind.config.cjs — Tailwind config, colors, fonts
└── tsconfig.json

All commands are run from the root of the project, from a terminal:

1. Click Use this template to create a new repo.

2. Set VERCEL_TOKEN, VERCEL_PROJECT_ID, and VERCEL_ORG_ID secrets to deploy to Vercel from GHA (enables access to git history).

   • Alternatively — if all your blog posts have a date in frontmatter, you don't need to deploy through workflows/ci.yml. Feel free to remove the deploy steps from the YML file and connect Vercel/Netlify integration. Go to derivedTitleAndDatePlugin function and remove execSync("git log") from it. (TODO: Can we make it more convenient?)

3. Add OG_IMAGE_SECRET to secure your OG image endpoint.