https://ma.tthewjohnson.com

This repository holds the source code to my blog (hosted at the URI above).

Getting started

1. Clone this repository
2. Run yarn to install the dependencies
3. Run yarn dev to start the website locally
4. Run yarn build to generate the assets/files to be deployed
5. Run yarn deploy to deploy to CloudFlare Pages
   • You may also need to set the environment variable CLOUDFLARE_API_TOKEN or configure wrangler to authenticate your terminal session with the CloudFlare API

What's the stack?

1. Hosted on CloudFlare Pages
   • why? CloudFlare Pages is an incredibly low-cost hosting provider and because of its distributed nature (CloudFlare is a CDN) it serves the content from a location/cache closest to the user
2. Built with SvelteKit
   • why? Svelte is a great framework for building websites, it has intuitive in-built support for animations, transitions and other modern web-design paradigms. SvelteKit has an adapter to build production content to CloudFlare pages as a JamStack application.
3. Styled with Tailwind CSS
   • why? Tailwind CSS is a simple, intuitive, modern framework for styling websites, I find it easy to use and better than similar libraries such as Bootstrap
4. TypeScript
   • why? there's very little code in this blog, but wherever there is code I choose to use TypeScript whenever possible because it is a strongly-typed language capable of achieving multiple programming paradigms
5. Markdown
   • why? Markdown is a an excellent format for writing content without the distractions of writing HTML directly. This repository uses a library (MDsveX) to convert Markdown files into HTML