sucker.severian.dev/.github/copilot-instructions.md

Copilot Instructions for sucker.severian.dev

Project Overview

• This is a Next.js project with a custom proxy API and UI components, using Tailwind CSS and PostCSS for styling.
• The main app logic is in src/app/, with global styles in globals.css and layout in layout.tsx.
• API routes are under src/app/api/proxy/, including image proxying (image/route.ts).
• UI components are in src/components/ui/ and utility functions in src/components/lib/.

Architecture & Data Flow

• The app uses Next.js routing and API routes for backend logic. The proxy API handles requests to external services, including image fetching and transformation.
• UI components follow a modular pattern, with reusable elements (e.g., button.tsx, card.tsx).
• Data flows from API routes to UI via React props and hooks. No global state management library is present.

Developer Workflows

• Build & Dev: Use npm run dev to start the development server. Check package.json for other scripts.
• Styling: Tailwind CSS is configured via tailwind.config.js and PostCSS via postcss.config.js.
• API: Custom logic for proxying and image handling is in src/app/api/proxy/. Review these files for request/response patterns.
• No test suite detected. If adding tests, follow Next.js and React conventions.

Project-Specific Conventions

• API routes use Next.js route.ts files, with custom logic for proxying and image manipulation.
• UI components are colocated in src/components/ui/ and use Tailwind utility classes.
• Utility functions (e.g., PNG handling) are in src/components/lib/.
• Minimal documentation; refer to code for implementation details.
• Changelog is maintained in README.md.

Integration Points & External Dependencies

• Relies on Next.js, React, Tailwind CSS, and PostCSS.
• External requests are proxied via custom API routes.
• Docker support via docker-compose.yml and dockerfile for containerization.

Examples

• To add a new API route: create a route.ts under src/app/api/yourroute/.
• To add a new UI component: place a .tsx file in src/components/ui/ and use Tailwind for styling.
• For image processing, review src/app/api/proxy/image/route.ts and src/components/lib/png.ts.

Key Files & Directories

• src/app/ — Main app logic and API routes
• src/components/ui/ — UI components
• src/components/lib/ — Utility functions
• tailwind.config.js, postcss.config.js — Styling configuration
• docker-compose.yml, dockerfile — Containerization
• README.md — Changelog and minimal project notes

---

If any section is unclear or missing important project-specific details, please provide feedback to improve these instructions.