Ship Stuff Faster

Product scaffolding so common I don't even claim to own it. Take it and build something with Next+Django already wired together. All of your 2 week problems solved with no 2 year problems projected onto you.

Features

  • JWT auth (access + refresh) via httpOnly cookies, with a Next.js proxy route that handles them for you.
  • Fail-loud environment variable validation at startup. Missing config values explode instead of failing silently later.
  • Base DRF viewset, serializer, pagination, and permission patterns ready to extend.
  • JobLock model for background jobs.
  • pytest + Hypothesis property-based tests included.
  • Worked IDOR (Insecure Direct Object Reference) test examples.
  • shadcn/ui + Tailwind 4 component scaffold for the Next.js frontend
  • Deliberately minimal. No Celery, Docker, or bullshit you don't need right now bundled in.
  • Unlicensed. Don't want to credit me? Don't.

Installation

Clone the repo, then drop its git history so you start clean:

git clone https://github.com/rmferguson/ship-stuff-faster my-project && cd my-project && rm -rf .git && git init

Search and replace the scaffold's placeholder project name throughout the codebase with your own project's name.

Set up the API: copy the environment template and install dependencies.

cp .env.example .env && poetry install && python manage.py migrate

Install the frontend dependencies the same way:

npm install

Run both dev servers in separate terminals - python manage.py runserver for the API, npm run dev for the Next.js app.