CLAUDE.md

Quick guidance for this prototype project.

Overview

Rapid prototyping project using TypeScript, React, and Node.js. Focus on speed and iteration over production-readiness.

Project Structure

project-root/
├── src/
│   ├── components/      # React components
│   ├── pages/           # Page components
│   ├── hooks/           # Custom hooks
│   └── utils/           # Utility functions
├── public/              # Static assets
├── tests/               # Test files
├── package.json
├── tsconfig.json
└── README.md

File Structure

src/components/ - Reusable UI components
src/pages/ - Route-level page components
src/hooks/ - Custom React hooks for shared logic
src/utils/ - Helper functions and utilities
tests/ - Unit and integration tests

Setup & Installation

# Install dependencies
npm install

# Start development server
npm run dev

# Run tests
npm test

Core Principles

Move Fast: Prioritize speed over perfection
Keep It Simple: Avoid unnecessary complexity
Iterate Quickly: Test and refine rapidly

Tech Stack

Frontend: TypeScript, React
Backend: Node.js, Express
Build: Vite
Testing: Jest, React Testing Library

Development Workflow

Create feature branch: git checkout -b feature/name
Implement and test locally
Commit changes: git commit -m "Add feature"
Push to remote: git push
Deploy to staging for testing

Quick Commands

npm run dev          # Start development server
npm test             # Run all tests
npm run build        # Build for production
npm run lint         # Check code quality

Project Type: Prototype Team Size: Solo Lines: ~75 (Minimal template with native format)

1.8 KiB Raw Permalink Blame History