mirsazzathossain.me

mirsazzathossain.me is an open-source personal website template from the GitHub repository of developer Mir Sazzat Hossain, built with Astro, Tailwind CSS v4, and MDX to serve as an academic portfolio and research site.

What is mirsazzathossain.me?

mirsazzathossain.me is a personal academic portfolio and research website template generated from a GitHub repository. It takes MDX posts and snippets in src/content, JSON data files in src/data for publications, projects, resources, courses, CV, and profile content, and outputs a static site through Astro's static build with the Vercel adapter. The template is created by Mir Sazzat Hossain and is publicly available for anyone to fork.

Key Features

The template comes with a fully custom design and these notable features:

• Astro framework with static output — Routes live in src/pages and components in src/components, with a Vercel adapter for deployment.
• React islands — Interactive UI islands are embedded into the otherwise static Astro pages, letting you add dynamic behavior where needed.
• Tailwind CSS v4 — Styling is configured through a Tailwind entry point and global layers in src/styles.
• MDX content collections — Blog posts and snippets are authored as MDX files in src/content, supporting components and embedded JSX.
• Math rendering — remark-math and rehype-katex are wired up to display LaTeX-style math in content.
• giscus comments — Posts can accept comments via giscus, which uses GitHub Discussions for storage.
• Vercel Analytics and Speed Insights — Analytics are integrated directly into the deployed site.
• Google Scholar sync — A GitHub Actions workflow named update-publications.yml runs weekly to fetch publication and citation data, while ci.yml runs a build check on every push and pull request.

Who is it for?

This template serves several specific user groups:

• Academics and researchers — Showcase publications and citations with automatic Google Scholar data sync, BibTeX, PDFs, and venue citation ranks stored in publications.override.json.
• Developers — Use the template as a clean starting point for a personal website with a custom design, TypeScript support, and a modern Astro stack.
• Bloggers and writers — Publish MDX posts and code snippets that support KaTeX math and reader comments.

What can you do with it?

• Researchers: sync their publication list and citation stats weekly from Google Scholar without manual edits to generated fields in publications.json.
• Writers: write posts in MDX with LaTeX math rendered by KaTeX and add comments via giscus powered by GitHub Discussions.
• Portfolio owners: manage projects, publications, courses, and CV entries as structured JSON data in src/data at build time.
• Forkers: customize the site by replacing personal content in src/data, src/content, public/images, public/files, and the site metadata in layout and config files.

How does it work?

After cloning the repository, run npm install and npm run dev to start a local development server at http://localhost:4321. Content is authored as MDX files and JSON data, then compiled into a static site by npm run build. Deployment on Vercel uses a build command of npm run build, output directory dist, install command npm install, and the repository root as project root. A weekly GitHub Action fetches fresh publication data from Google Scholar, while a CI workflow validates the build on each push and pull request.

FAQ

Is this template free?

Yes. The repository is public on GitHub, and the author explicitly states you can use it as a template to build your own personal website. There is no mention of any paid license or commercial restriction.

What stack does mirsazzathossain.me use?

The template uses Astro with static output and the Vercel adapter, React for interactive islands, Tailwind CSS v4 for styling, and MDX content collections for posts. It also integrates giscus, Vercel Analytics, and Google Scholar via GitHub Actions.

How do I deploy this template?

Deploy on Vercel with the repository root as project root. Set the build command to npm run build, the output directory to dist, and the install command to npm install. The site also includes a CI workflow that runs a production build check for pushes and pull requests.

Can I use this template as a starting point for my own site?

Yes. The README instructs forkers to replace the personal content in src/data, src/content, public/images, public/files, and the site metadata in layout/config files before publishing.

Does the site support math equations?

Yes. The content pipeline includes remark-math and rehype-katex, so MDX posts can render LaTeX-style math equations in the browser via KaTeX.