khr1st

This is the blog that powers khr1st.vercel.com, built on next.js and deployed to the cloud via Vercel.

this blog is for feature breakdowns & analysis of bleeding edge technologies

my other technical blog with much more educational content is found here khr1st.com for longer form demonstrative post.

How to run

First, install Vercel CLI.

Development

vc dev

Deployment

Staging

vc

This is the equivalent of submitting a PR with the GitHub integration

Production

vc --prod

This is the equivalent of git push to master (or merging a PR to master)

Architecture

Pure components

Every stateless pure component is found under ./components.

Every component that has to do with styling the post's markup is found under ./components/post/

These components make up the style guide of the application.

Blog posts

Every blog post is a static page hosted under pages/$year/.

This allows every post to load arbitrary modules, have custom layouts and take advantage of automatic code splitting and lazy loading.

This means that the bloat of a single post doesn't "rub off on" the rest of the site.

An index of all posts is maintained in JSON format as ./posts.json for practical reasons.

Create New Post

Every post is under /pages/$year/ if no directory is found for the current year create it.

Create a folder for the post name such as 2024-in-review and place the .mdx post file inside of it.

Then add the updated information into links.json to populate the home feed.