# UltimateShop - Next.js E-commerce Application

## Project Overview
UltimateShop is a Next.js-based e-commerce application built with TypeScript and the App Router. It features user authentication, registration, and funds management functionality.

## Technology Stack
- **Framework**: Next.js 15.5.3 with App Router
- **Language**: TypeScript
- **Database**: Supabase
- **Styling**: CSS with custom stylesheets
- **Build Tool**: Turbopack (Next.js)

## Project Structure
```
src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   ├── funds/             # Funds management pages
│   ├── login/             # Login functionality (redirects to root)
│   ├── register/          # User registration
│   ├── layout.tsx         # Root layout
│   ├── page.tsx           # Homepage (login form)
│   └── sitemap.ts         # Sitemap generation
├── lib/                   # Utility libraries
│   ├── supabase.ts        # Supabase client configuration
│   └── useAuth.ts         # Authentication hook
public/
├── css/                   # Stylesheets
├── fonts/                 # Web fonts
├── images/                # Static images
├── js/                    # JavaScript files
└── captcha/               # Captcha images
```

## Key Features
1. **User Authentication**: Login/logout functionality with localStorage
2. **User Registration**: Registration form with captcha validation
3. **Funds Management**: User funds tracking and management
4. **Responsive Design**: Mobile-friendly interface
5. **Security**: Captcha protection and secure authentication

## Important Notes for AI Assistants
- The login page is now the homepage (/) - users see login form immediately
- /login route redirects to the root page
- Registration includes captcha validation with stable image display
- All authentication redirects point to root (/) instead of /login
- Uses Supabase for backend services
- Custom CSS styling (no Tailwind or CSS-in-JS)

## Development
- **Dev Server**: `npm run dev` (runs on http://localhost:3000)
- **Build**: `npm run build`
- **Linting**: ESLint configured

## File Conventions
- Components use PascalCase (e.g., RegisterForm.tsx)
- Pages follow Next.js App Router conventions
- Static assets organized by type in public/ directory

## Recent Changes
- Moved login functionality to homepage
- Fixed captcha stability issues in registration
- Updated all internal navigation to use Next.js Link components
- Resolved build errors and linting warnings

This application follows Next.js best practices and maintains clean, maintainable code structure.