Personal Website Starter Kit

🪴 Plant
#ai-coding 2 minutes read 14 Mar, 2025

I recently open-sourced my astro-blog-ghost GitHub repository - a modern blog template built with AstroJS and Ghost CMS integration. This project serves as an excellent starting point for developers looking to create a portfolio website with:

  • 📦 Zero-client JavaScript by default (with opt-in hydration)
  • 🚀 Built-in Ghost CMS integration for content management
  • 🌓 Dark/light mode toggle with system preference detection
  • 📱 Mobile-optimized responsive layouts
  • 🎨 CSS custom properties for easy theming
  • 🔍 SEO optimization with automatic sitemap generation
  • 📄 MDX support for interactive components in posts

To create your own portfolio:

  1. Clone the repository: git clone https://github.com/shreyas-makes/astro-blog-ghost
  2. Install dependencies: npm install
  3. Connect to Ghost CMS via .env file
  4. Customize the src/config.ts with your personal details
  5. Modify components in src/components/ to match your style

Key customization points:

  • Update color schemes in src/styles/global.css
  • Add portfolio sections in src/pages/
  • Create custom page layouts in src/layouts/
  • Implement your preferred analytics in src/components/scripts/

The template supports: ✅ Blog posts with code syntax highlighting ✅ Project showcases with responsive images ✅ About page with Markdown/MDX content ✅ RSS feed generation ✅ Open Graph protocol implementation

Deploy to any static host (Vercel, Netlify, GitHub Pages) with built-in CI/CD pipelines.

[Read this essay]([[How I blog blog with Obsidian, Cloudflare, AstroJS, Github]]) to know more about how I use Obsidian for publishing my blog posts on AstroJS.

Found a typo or want to suggest changes? Send a PR on GitHub

Liked this post? Get email for new ones:

Here are some popular posts you might like

Read writers who operate

We have more books on birds written by ornithologists than books on birds written by birds, and books on ornithologists written by birds. Taleb eloquently describes this as the key problem of knowledge, or in other words as _epistemic arrogance_. Strong corollary can be drawn with various disciplines, including entrepreneurship. Entrepreneurs simply spend more time doing entrepreneurship rather than writing about entrepreneurship. It's very difficult for successful entrepreneurs who are in the thick of action, to be talking about action....

writing
Virtual bookshelves

There's something special about the moment when a guest visits your home, browses your bookshelf, and discovers a book you both cherish. That spark of connection often leads to meandering conversations that weave through shared interests and unexpected topics. It's an experience that became harder to recreate after moving between continents and various work locations. This desire to preserve this simple joy of connection through books led me to explore the concept of virtual bookshelves. I first stumbled upon [Derek Sivers' implementation](https://sive.rs/book) and was drawn to his thoughtful collection of over 400 book notes and meta-commentaries spanning diverse themes. What stood out was how these notes went beyond standard reviews found on Goodreads or Amazon—they contained personal insights and deeper reflections that sparked genuine curiosity....

aesthetics
Making Nielsen's heuristics more digestible

Jakob Nielsen's heuristics are probably the most-used usability heuristics for the design of interfaces. If you go to their website, you might encounter these dry prescriptive statements as shown in the image....

design
Copy, Paste and Cite

Managing academic references often creates an unwelcome interruption in the natural flow of writing and research. This friction became particularly noticeable during long stretches of paper writing, where the context switching between composition and citation management kept breaking concentration. The ideal scenario would let references appear when needed without leaving the writing environment. After several frustrating experiences of lost focus while hunting for citations, I shipped this Raycast plugin for Zotero began taking shape. The concept was straightforward: make reference management fade into the background while still providing immediate access to a scholarly library when needed....

llm
Obsessing over personal websites

Intended Audience—For those of us who have attempted to make a personal website of their own and have guilt-tripped over making multiple updates every year I’ve been obsessed with my personal website. It’s not even about the views and impressions which I’m receiving. I have one subscriber on my mailing list from my website, and compared to internet writer standards, I am virtually non existent. ...

software