Show HN: I made a developer blog project with Astro and Tailwind
github.com
I made a coding blog with Astro. It is pretty comprehensive project, built as a result of a thorough research of the current ecosystem and the existing open source examples, I tried to compile all the best solutions that I found in each of them and customize it to my own preference.
This is the Github repository for the project:
https://github.com/nemanjam/nemanjam.github.io
Live website is here:
The main website uses Nginx, there are two additional mirrors with Github Pages and Docker:
https://nmc-docker.arm1.nemanjamitic.com
You can see the complete feature list in the projects Readme, here I will note some of them:
It is the latest Astro, high performance, static website, has Post and Project content collections, Tailwind for styling with clean separated structure, supports both dark/light modes and color themes with semantic colors, has support for both Tags and Categories, has Astro View Transitions that work in Chrome, Astro optimized images, all sizes are extracted as constants and reused, its fully Typescript, Zod is used for runtime (build-time) validation for content collections and config with environment variables, has usual code quality setup with ESLint and Prettier with sorted imports and paths aliases, uses class-variance-authority for components style variants, has React integration for interactive components, has separate design system on `/design` route, has clear hierarchical layouts, well structured metadata handling and sitemap generation for good SEO, endpoint for generating Open Graph images for every page with Satori and html template with random color gradients, syntax highlighting for embedded code, embeds for Tweets, Youtube, OG links, comments with Giscus, social share button for posts, draft posts with preview mode, RSS and Json feed endpoints, has 3 different deployment methods - Nginx, Github Pages and Docker, available both locally and as Github Actions workflows, support for building both x86 and arm Docker images, deployment workflows are abstracted as Bash scripts and reused both locally and in Github Actions for easy local debugging.
There is a roadmap with additional features that I plan to add, currently the project is approximately 80-90% completed but it is stable enough to start populating and publishing real content, so I decided to share it with public.
I am not a designer, so the design is a bit raw and can be improved and polished further but the part that I put the most attention and care is the code quality, structure and readability, I made effort to make it stable, well separated, clean, understandable and maintainable in long period to come, because I plan to use it and publish coding articles in years to come.
All constants, types, utilities, configs, queries, styles, assets are extracted, reused, well separated, readable and easy to understand. I tried to reduce unnecessary complexity and noise as much as I can.
There is 4k characters limit for the initial message, I will continue in the next comment: