vivsha.ws

this is my website. it's a static site built with React. i use it for personal details and blogging.

up and running

yarn
yarn prepare
yarn dev

repo structure

the code is split into several packages using Yarn workspaces:

• ./apps/vivsha.ws: the Next.js app for the site
• ./packages/basalt: the Basalt design system (components, tokens, CSS reset)
• ./packages/basalt-mdx: prebuilt MDX components styled with Basalt

content lives outside the code in separate top-level folders, for a distraction-free writing environment:

• ./posts: blog posts (one directory per post, each with a post.mdx)
• ./pages: standalone pages like about and colophon

scripts

these scripts should be run from the monorepo root:

command	what it does
yarn dev	start the Next.js dev server
yarn build	build the static site
yarn typecheck	typecheck all packages
yarn lint	lint everything with oxlint
yarn format	format everything with oxfmt
yarn new:post	scaffold a new blog post via hygen

see the individual packages for package-level commands.

deployment

vivsha.ws is a fully static app. it's deployed via this GitHub Action to GitHub Pages.

why vivsha.ws?

i wanted vivsh.aw but that proved annoying, so i settled for vivsha.ws. read it like: "vivshaw's", as in "vivshaw's webbed sight".

if it lives at vivsha.ws, why does it live in a repo called vivshaw.github.io?

two reasons, both related to the requirements for GitHub user pages.

• i used to host my blog at that URL, and i would like it to continue working, with a redirect to my new URL.
• i'd prefer all my GitHub Pages to live under vivsha.ws.

the easiest way to accomplish these things is by setting a custom domain for my user site.