joaocosta.dev Blog

This is the source code for my personal blog, joaocosta.dev. It's a statically generated site built with Next.js and styled with Tailwind CSS.

Content Management

Blog posts are written and managed in Joplin. A GitHub Action runs periodically to pull the latest content from Joplin and commit it to this repository.

The images in the posts are places in the public/_resources directory.

Tech Stack

• Next.js - Framework.
• TypeScript - Lang.
• Tailwind CSS - Styling framework.
• gray-matter - For parsing front-matter from markdown files.
• react-markdown - For rendering Markdown files.

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Bun

Installation

1. Clone the repo:

   git clone https://github.com/JoaoCostaIFG/website.git

2. Install dependencies:

   bun install

Running the Development Server

To view the site in development mode, run:

bun dev

Open http://localhost:3000 with your browser to see the result.

Building the Project

To build the site for production, run:

bun run build

This will create a static, production-ready build in the .next directory.

Docker

Deployments are made using docker. There's a action building the docker image for this site.