einbiogpt: Instructions file for Codex

AGENTS.md - Coding Guidelines for AI Agents

Project Overview

• Framework: Next.js 14+ with App Router
• Language: TypeScript 4.9.4
• UI: React 18.2.0 + Tailwind CSS 3.2.4
• Components: shadcn/ui (Radix UI primitives)
• Package Manager: Yarn 1.22.22
• Language: Persian/Farsi (RTL direction)

Build/Development Commands

# Development server
yarn dev

# Production build
yarn build

# Start production server
yarn start

# Clean and reinstall dependencies
yarn run clean

# Docker commands (via Makefile)
make build          # Build Docker containers
make start          # Start containers in detached mode
make logs           # View container logs
make stop           # Stop containers

Note: No lint, test, or format commands are currently configured.

Code Style Guidelines

TypeScript Configuration

• Target: ES5
• Strict mode enabled
• Module resolution: Node
• Path alias: @/* maps to root directory
• JSX: preserve (Next.js handles compilation)

Import Order

1. React/Next.js imports
2. Third-party libraries
3. Internal UI components (@/components/ui/*)
4. Other internal components (@/components/*)
5. Utilities (@/lib/utils)
6. Types
7. Styles

Naming Conventions

• Components: PascalCase (e.g., BioGenerator, Header)
• Hooks: camelCase starting with use (e.g., useState)
• Utilities: camelCase (e.g., cn, errorHandler)
• Types/Interfaces: PascalCase (e.g., ButtonProps)
• Files: kebab-case for utilities, PascalCase for components

Component Structure

"use client"; // If client component (before imports)

import { useState } from "react"; // React imports first
import { motion } from "framer-motion"; // Third-party
import { Button } from "@/components/ui/button"; // UI components
import { cn } from "@/lib/utils"; // Utilities

// Types
interface Props {
  // ...
}

// Component
export const ComponentName = ({ prop }: Props) => {
  // Hooks
  const [state, setState] = useState();
  
  // Handlers
  const handleClick = () => {};
  
  // Render
  return <div>...</div>;
};

export default ComponentName;