satnaing/astro-paper

AstroPaper is a ready-made blog theme built with Astro, a website-building framework designed to produce fast static sites. The theme is meant for people who want to start a personal blog without designing one from scratch. It was originally created for the author's own blog and then released publicly. The theme comes with light and dark mode, a fuzzy search feature so readers can find posts, support for draft posts that are not published yet, pagination to split long post lists across multiple pages, and automatically generated sitemap and RSS feed files that help search engines discover and index content. Each blog post also gets an automatically generated social preview image. The design is mobile-friendly and has been tested for keyboard navigation and screen reader accessibility using VoiceOver on Mac and TalkBack on Android. Blog posts are written in Markdown files stored in a folder inside the project. Astro turns each file into a web page. Configuration is done through a TypeScript file where you set your site's name, description, and other details. Color schemes can be changed, and the README links to documentation for customizing them. Styling is handled through TailwindCSS, a utility-based styling system. To get started, you run a single command that uses Astro's project creation tool with AstroPaper as the template. After that you install dependencies and run a development server that shows the site in your browser. For deployment, the project is configured for Cloudflare Pages, a free static hosting service, though Astro sites can be deployed to many other platforms. A Docker option is also included for running it in a container. The license is MIT. The project includes a Figma design file for anyone who wants to inspect or modify the visual design outside of code.