Wezero Studio - Standard Operating Procedures

This repository contains the engineering standards, best practices, and SOPs for all Wezero Studio projects.

Every new project should follow these guidelines. Existing projects should be migrated incrementally.

Table of Contents

CI/CD

• CI/CD & Deployment - GitHub Actions + Cloudflare Pages

Code Quality

• Code Quality - ESLint, treefmt/Prettier, lefthook, TypeScript strict
• Package Manager - Use bun exclusively

Standards

• README Standards - Every repo needs a real README
• SEO & Social Sharing - Favicon, title, OpenGraph

Architecture

• Common Anti-Patterns - What to avoid
• New Project Checklist - Quick-start checklist

Environment

• Environment Variables - .env.example required

Quick Start

Starting a new project? Clone the template:

git clone https://github.com/wezero-studio/template-nextjs my-project
cd my-project

# With Nix (recommended)
nix develop
bun install

# Without Nix
bun install
lefthook install

Then go through the New Project Checklist.