Languages, Frameworks & Styling

Paved Path

• Backend: Node.js Express (TypeScript)
• Frontend: Next.js (App Router, React)
• Styling: Design tokens + TailwindCSS (tokens provided from a shared package)
• IaC: Terraform
• Testing: Jest (see Testing section)
• CI/CD: GitHub Actions

LLM Notes

• Prefer Express over Nest/Koa. Prefer Next.js App Router over Pages Router.
• Use Tailwind utilities + design tokens; avoid ad‑hoc CSS frameworks unless an ADR approves.

Sample token usage

export const tokens = {
  color: { brand: '#36d19b', text: '#0f172a', muted: '#64748b' },
  radius: { md: '12px', lg: '16px', xl: '24px' },
  spacing: { sm: 8, md: 12, lg: 16, xl: 24 },
};

import type { Config } from 'tailwindcss';
export default {
  content: ['apps/**/*.{ts,tsx}', 'packages/**/*.{ts,tsx}'],
  theme: {
    extend: {
      colors: { brand: '#36d19b' },
      borderRadius: { md: '12px', lg: '16px', xl: '24px' }
    }
  },
  plugins: []
} satisfies Config;