devblog

devblog is a personal software development blog built with Next.js. It is a place for tutorials, opinions, rants, suggestions, experiments, and other writing that fits a developer blog, with an extra playground page for small games and interactive side projects.

This project is intentionally simple. It is a hobby project first, but it also works as a way to show frontend and product-building capability without turning into a heavy CMS.

Features

• Personal blog structure with home, recent, trending, tag, search, post, profile, about, and playground pages
• Responsive, polished UI with custom layouts, card-based sections, and interactive details
• Topic discovery through recent posts, trending posts, tags, and search
• Social authentication foundation with NextAuth and Prisma
• GitHub and Google providers configured in the auth route
• Role-aware authoring flow for creating posts
• Playground page with small games, sketches, and interactive experiments
• Prisma schema for users, posts, comments, bookmarks, feedback, and reading progress

Stack

• Next.js
• React
• Tailwind CSS
• Prisma
• NextAuth
• PostgreSQL
• Phaser
• Three.js

Running Locally

Install dependencies:

npm install

Create an .env file with at least:

DATABASE_URL=...
SITE_URL=https://your-production-domain.example
NEXT_PUBLIC_SITE_URL=https://your-production-domain.example
BLOB_READ_WRITE_TOKEN=...
AUTH_URL=https://your-production-domain.example
NEXTAUTH_URL=https://your-production-domain.example
OWNER_EMAIL=owner@example.com

OWNER_EMAIL is optional. That account is promoted to owner when it registers or signs in. The owner can then promote the first admin from the /admin page, and admins can manage lower roles from there.

If you want to test social login locally, also configure the provider credentials required by Auth.js for the GitHub and Google providers used in app/api/auth/[...nextauth]/route.ts.

Start the app:

npm run dev

Then open http://localhost:3000.

Notes

• This is not meant to be a complex publishing platform.
• The project favors a minimal, authored feel over lots of product surface area.
• The playground exists because I like building small interactive things, not because this is a game-dev portfolio.

SEO

SEO metadata, robots.txt, and sitemap.xml are generated at runtime from app/layout.tsx, app/robots.ts, and app/sitemap.ts. Set SITE_URL and NEXT_PUBLIC_SITE_URL to the live domain so canonical URLs, social metadata, and sitemap entries point at production.