Blog

JamBalaya56562's blog created by Next.js

📄 Get Started

To clone and run this application, you'll need Git and Mise installed on your computer.
From your command line:

1. Clone this repository

git clone https://github.com/JamBalaya56562/blog.git

2. Install dependencies with bun

cd blog && bun i

3. Set up the local database

This project uses PostgreSQL for page view tracking. Docker is required.

# Full setup: generate .env, start PostgreSQL, wait for health check, push schema
mise run db:setup

Or run each step individually:

# Generate .env with default values
mise run db:env

# Start PostgreSQL container (postgres:18-alpine)
mise run db:start

# Wait for PostgreSQL to be healthy
mise run db:health

# Push Drizzle schema to database
mise run db:push

# Open Drizzle Studio (DB GUI)
mise run db:studio

# Stop PostgreSQL container
mise run db:stop

4. Develop the app

bun dev

5. Test the app

bun test:unit

6. E2E Test

bun test:e2e

7. Format and Lint the files

bun lint:fix

8. Build the app

bun run build

9. Start the app

bun start

⚙️ Environment Variables

Variable	Description	Default
DATABASE_URL	PostgreSQL connection string	postgresql://blog:blog_dev_password@localhost:5433/blog
CONTENT_SOURCE	Content source ("local" or "github")	"local"
GITHUB_OWNER	GitHub repository owner	-
GITHUB_REPO	GitHub repository name	-
GITHUB_BRANCH	GitHub branch name	"main"
GITHUB_CONTENT_PATH	Root path for content in the repository	"content"

🆚 VSCode

Visual Studio Code is the recommended IDE for working on this project, as it has been configured.

Once opening, you can run Extensions: Show Recommended Extensions to install the recommended extensions for good development is automatically configured.

🐳 Dev Containers

A dev container is a running container with a well-defined tool/runtime stack and its prerequisites.
You can try out dev containers with GitHub Codespaces or Visual Studio Code Dev Containers.

Setting up the dev container

GitHub Codespaces

GitHub Codespaces is a cloud-based development environment that allows you to work on this project directly in your browser.
You can click the badge above or here to get started.

Follow these steps to open this project in a Codespace:

1. Click the Code drop-down menu.
2. Click on the Codespaces tab.
3. Click Create codespace on main.

For more info, check out the GitHub documentation.

VSCode Dev Containers

Follow these steps to open this project in a container using the VSCode Dev Containers extension:

1. If this is your first time using a dev container, please ensure your system meets the pre-reqs (i.e. have Docker installed) in the getting started steps.

2. To use this repository, open a locally cloned copy of the code:

   • Clone this repository to your local filesystem.
   • Press F1 and select the Dev Containers: Open Folder in Container... command.
   • Select the cloned copy of this folder, wait for the container to start, and try things out!

🫶 Contribute

Want to report a bug, contribute some code, or improve the documentation? Excellent!
Read up on our guidelines for contributing and Code of Conduct.
Then check out one of our issues labeled as 😵‍💫help wanted or good first issue.

♥️ Contributors

📦 Credits

This software uses the following open source packages:

• AWS Lambda Web Adapter
• Biome
• Bun
• Drizzle ORM
• HAPPY DOM
• Mise
• Next.js
• Node.js
• Playwright
• PostgreSQL
• React
• StackBlitz Codeflow
• Tailwind CSS
• TypeScript

⚖️ License

The MIT License Copyright (c) 2026 - JamBalaya56562. Please have a look at the LICENSE for more details.