Templates

# AGENTS.md

## Project

Acme Dashboard is a Next.js app where customers track their orders. TypeScript throughout,
Postgres through Drizzle, deployed as a Docker image.

## Setup

- Install dependencies: `pnpm install`

---
name: review-pr
description: Review the current branch or a pull request against this project's checklist. Use when asked to review changes, check a PR or look over a diff before merging.
---

# Review a pull request

Review the changes against the main branch and report problems, ordered by how much they matter.

## Steps

# Acme Dashboard

A Next.js app where customers track their orders. It reads and writes a Postgres database
through Drizzle and ships as a Docker image.

## Commands

- Install: `pnpm install`
- Dev server: `pnpm dev`, then open http://localhost:3000
- All tests: `pnpm test`

---
description: Project overview, commands and rules that apply to every task
alwaysApply: true
---

# Acme Dashboard

Next.js App Router, TypeScript, Tailwind CSS and Drizzle on Postgres.

## Commands

{
  "mcpServers": {
    "sniptide": {
      "type": "http",
      "url": "https://app.sniptide.com/api/mcp"
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {

{
	# Let's Encrypt sends certificate expiry notices here.
	email [email protected]
}

example.com {
	encode zstd gzip

	reverse_proxy localhost:3000

services:
  db:
    image: postgres:17
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-app}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-app}
      POSTGRES_DB: ${POSTGRES_DB:-app}
    ports:
      - "127.0.0.1:5432:5432"

# syntax=docker/dockerfile:1
# Needs output: "standalone" in next.config.ts.

FROM node:24-alpine AS base
WORKDIR /app
RUN corepack enable

# Install dependencies only when the lockfile changes.
FROM base AS deps
COPY package.json pnpm-lock.yaml ./

# Copy this file to .env and fill in the values: cp .env.example .env
# Commit .env.example. Never commit .env.

# --- App ---
# development, test or production
NODE_ENV=development
# The public URL of the app, without a trailing slash
APP_URL=http://localhost:3000
PORT=3000

name: CI

on:
  push:
    branches: [main]
  pull_request:

# A new push to the same branch or pull request cancels the run still in progress.
concurrency:
  group: ci-${{ github.ref }}

name: Bug report
description: Something doesn't work the way the docs say it should.
title: "[Bug]: "
labels: ["bug", "triage"]
body:
  - type: markdown
    attributes:
      value: |
        Thanks for taking the time to report this. Please search open issues first, since
        someone may have reported it already.

# CSV export for invoices

Status: Ready to build
Owner: Dana (product), Sam (engineering)
Updated: 2026-11-08

## Problem

Accountants ask for a spreadsheet of invoices every month. Today support exports it by hand from
the database, which takes about 20 minutes per request and arrives a day late.

# Team invites

Epic: Workspaces for teams
Updated: 2026-11-08

## Story 1: Invite a teammate by email

As a workspace owner, I want to invite a teammate by email, so that they can see and edit our
invoices without sharing my login.

# Changelog

All notable changes to Acme are listed here. The format follows
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

# Acme

> Acme is an invoicing API for small businesses. This file lists the pages an AI assistant needs to answer questions about Acme and to write code against its API.

The API is REST over HTTPS with JSON bodies. Every request needs an API key in the `Authorization` header. Amounts are integers in the smallest currency unit, so 1999 means 19.99.

## Docs

- [Quickstart](https://acme.dev/docs/quickstart.md): Create an API key and send your first invoice in five minutes
- [Authentication](https://acme.dev/docs/authentication.md): API keys, test and live mode, and key rotation

# robots.txt for acme.com
# Search engines and AI search can read the site.
# Crawlers that collect training data can't.

# AI search and assistants fetching a page for a user
User-agent: OAI-SearchBot
User-agent: ChatGPT-User
User-agent: Claude-SearchBot
User-agent: Claude-User
User-agent: PerplexityBot

# Acme voice

Read this before writing anything a customer will see: the site, emails, the app, the docs and
social posts. It applies to people and to AI tools drafting copy for us.

## Who we write for

Freelancers and small agencies who send invoices between client work. They are busy, they are
not accountants, and they read on their phones.

---
title: Invite your team to Acme
description: Owners can now invite teammates as Owners, Editors or Viewers, so a whole agency can work on its invoices together.
date: 2026-11-04
---

# Invite your team to Acme

Until today, an Acme workspace had one login, and agencies shared it. Starting today, owners can
invite their team, and each person signs in as themselves with a role that decides what they can