Conventions

The rules I set up at the start of a project so the codebase stays easy to find your way around.

Conventions only help if they're written down. These are the ones I use in my Next.js projects, and they're also shared with AI editors (Cursor and Claude Code) as rule files, so generated code follows them too.

Project structure

Where every kind of file lives, and why business logic sits in feature folders.

Naming and imports

File naming, absolute imports, and why there are no barrel files.

Commits

Conventional Commits, and what my early commit history taught me.

Last updated on

Introduction

What Workbench is, who it's for, and how the notes are organised.

Project structure

A src/ layout where shared code and feature code never mix, and every magic string has one home.