Files
2025-11-12 11:19:48 +01:00

81 lines
1.8 KiB
Markdown

# 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
```bash
# Install dependencies
npm install
# Start development server
npm run dev
# Run tests
npm test
```
## Core Principles
1. **Move Fast**: Prioritize speed over perfection
2. **Keep It Simple**: Avoid unnecessary complexity
3. **Iterate Quickly**: Test and refine rapidly
## Tech Stack
- **Frontend**: TypeScript, React
- **Backend**: Node.js, Express
- **Build**: Vite
- **Testing**: Jest, React Testing Library
## Development Workflow
1. Create feature branch: `git checkout -b feature/name`
2. Implement and test locally
3. Commit changes: `git commit -m "Add feature"`
4. Push to remote: `git push`
5. Deploy to staging for testing
## Quick Commands
```bash
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)