Skip to content

ruphaa/ruphaa-blogster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ruphaa.dev

Built with Astro Styled with Tailwind TypeScript License: MIT

πŸͺ΄ My personal corner of the internet β€” a digital garden where I share what I learn, what I build, and what I write.

🌐 Live Site Β· πŸ’¬ Say Hi


✨ What's Inside

This site is intentionally simple β€” a lightweight, fast, and joyful place to collect thoughts and work.

  • πŸŒ— Light / Dark mode β€” Toggle your preferred vibe anytime
  • πŸ“¦ Collapsible Archives β€” Old content tucked away neatly, still easy to find
  • πŸ“ Markdown-powered β€” All content lives in plain .md files via Markdoc
  • πŸ“‘ RSS Feed β€” Subscribe at /rss.xml
  • πŸ“± Fully Responsive β€” Looks great on every screen size
  • ⚑ Blazing Fast β€” Statically generated with Astro

πŸ›  Tech Stack

Layer Tech
Framework Astro β€” zero-JS by default, islands when needed
Styling Tailwind CSS β€” with a custom "bubblegum" theme
Content Markdoc β€” Markdown with structure & validation
Type System TypeScript
Icons Font Awesome

πŸ—‚οΈ Content

The site is organized into three curated spaces. Older posts live in Archives β€” click to expand and browse.

Section Route What Goes Here
Write /write Blog posts, tutorials, and deep dives
Build /build Side projects and things I've shipped
Learn /learn Book notes, quick thoughts, and snippets

πŸš€ Getting Started

# 1. Clone the repo
git clone https://github.com/ruphaa/ruphaa-blogster.git
cd ruphaa-blogster

# 2. Install dependencies
npm install

# 3. Start the dev server
npm run dev

# 4. Open http://localhost:9000

Build for Production

npm run build

The static output lands in the dist/ folder, ready for Netlify, Vercel, or any static host.


✏️ Adding Content

Everything lives in the content/ directory as plain Markdown files with YAML frontmatter.

Blog Post (content/write/)

---
external: false
title: "Your Post Title"
date: 2024-06-15
ogImagePath: "/images/blog/your-image.png"
---

Your post content here. Supports images, code blocks, embeds, and more.

Set external: true and add a url: field for posts that live elsewhere.

Project (content/projects/)

---
title: "Project Name"
description: "What it does"
date: 2024-06-15
url: https://github.com/ruphaa/your-project
---

Projects are always external links β€” great for linking to GitHub repos, live demos, or case studies.

Writing / Library Note (content/library/)

---
external: false
title: "Note Title"
date: 2024-06-15
---

Book notes, quick thoughts, or anything worth remembering.

πŸ— Project Structure

ruphaa-blogster/
β”œβ”€β”€ content/                 # All Markdown content
β”‚   β”œβ”€β”€ write/               # Write β€” blog posts & tutorials
β”‚   β”œβ”€β”€ projects/            # Build β€” projects
β”‚   └── library/             # Learn β€” book notes & snippets
β”œβ”€β”€ public/                  # Static assets (images, fonts, favicons)
β”‚   └── fontawesome/         # Self-hosted icon font
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # Astro UI components (Header, Footer, Nav, etc.)
β”‚   β”œβ”€β”€ layouts/             # Page layouts & HTML skeleton
β”‚   β”œβ”€β”€ lib/                 # Helpers, SEO, Markdoc config, content reader
β”‚   β”œβ”€β”€ pages/               # Astro file-based routing
β”‚   └── styles/              # Global CSS, Tailwind theme, typography
β”œβ”€β”€ astro.config.mjs         # Astro configuration
β”œβ”€β”€ tailwind.config.cjs      # Tailwind + custom color tokens
└── package.json

🎨 Theme

The site uses a playful "bubblegum" color palette with light and dark modes. Colors are defined as CSS custom properties in src/styles/theme.css and mapped through tailwind.config.cjs.

Toggle the theme with the sun/moon button in the header β€” your preference is saved in sessionStorage.


πŸ™ Acknowledgements

This site was originally scaffolded with Blogster, a wonderful Astro blog starter by Dinesh Pandiyan. I've since reshaped the navigation, added archives, built out the theme toggle, and made it my own β€” but the solid bones are all Blogster.


πŸ“„ License

MIT Β© Ruphaa Ganesan

About

Ruphaa's digital garden

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors