foamking/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

FoamKing is a Danish flooring price calculator web application for Foam King Gulve. The calculator will be hosted at beregner.foamking.dk and provides instant price estimates for floor solutions including insulation, floor heating, synthetic mesh, and self-leveling compound.

Technology Stack

Planned stack: Next.js + shadcn/ui + Tailwind CSS

• Next.js: For server-side rendering and API routes
• shadcn/ui: For accessible, customizable components
• Tailwind CSS: For styling
• Custom theme: Already defined in docs/shadcn theme.txt

Project Status

Currently in documentation phase - no implementation exists yet. Key documentation files:

• docs/projektplan.md - Complete project plan and requirements
• docs/prisbeskrivelse.md - Detailed pricing logic and formulas
• docs/shadcn theme.txt - Custom shadcn theme (blue/orange color scheme)
• docs/foam king logo.png - Company logo

Core Requirements

Input Form Fields

• Name (required, min 2 chars)
• Email (required, valid format)
• Phone (required, 8 digits)
• Postal code (required, 4 digits Danish)
• Address (optional)
• Floor area: 25-300 m²
• Floor height: 0-100 cm
• Remarks (optional)

Price Calculation Components

1. Insulation: 3,730 kr/m³ (subtract 5cm from height for concrete)
2. Floor heating: 205 kr/m² (always included)
3. Synthetic mesh: 49 kr/m² (always included)
4. Self-leveling compound: 450 kr/m² (90 kg/m²)
5. Pump truck fee: Based on compound weight (0-8,100 kr)
6. Start fee: 3,500 kr fixed
7. Transport: 18.75 kr/km round-trip from 4550 Asnæs
8. Percentage fees: 0.95% for covering/waste
9. VAT: 25%

Output

• Price estimate with ±10,000 kr variation
• Option to request binding quote (sends email to info@foamking.dk)

Implementation Guidelines

Distance Calculation

Three options for calculating transport distance:

1. Postal code table (recommended for MVP)
2. OpenRouteService API (free up to 2,000 requests/day)
3. Google Maps API (paid)

Coverage Areas

• 4000-4999: West Zealand
• 2000-2999: Copenhagen
• 3000-3999: North Zealand
• 4800-4899: Lolland-Falster
• 5000-5999: Funen (+500 kr Great Belt bridge fee)

Development Commands

Since this is a new project, typical Next.js commands will apply once initialized:

# Initialize project
npx create-next-app@latest . --typescript --tailwind --app

# Install shadcn/ui
npx shadcn@latest init

# Development
npm run dev

# Build
npm run build

# Start production
npm start

# Lint
npm run lint

# Type check
npm run typecheck

Key Implementation Tasks

1. Create responsive form with validation
2. Implement price calculation logic from prisbeskrivelse.md
3. Apply custom shadcn theme from shadcn theme.txt
4. Add distance calculation (start with postal code table)
5. Create email functionality for quote requests
6. Add error handling and loading states
7. Ensure mobile-responsive design

Testing Scenarios

Test with examples from prisbeskrivelse.md:

• 50 m², 20 cm height, 2100 Copenhagen → ~95,500 kr
• Edge cases: minimum (25 m²) and maximum (300 m²) areas
• Different pump truck weight thresholds
• Funen postal codes for bridge fee

Security Considerations

• Never commit API keys (note: mail.txt contains credentials - DO NOT use these)
• Validate all user input server-side
• Rate limit API endpoints
• Sanitize data before sending emails

Project Structure (Recommended)

/
├── app/
│   ├── api/
│   │   ├── calculate/
│   │   └── quote-request/
│   ├── components/
│   │   ├── calculator/
│   │   └── ui/
│   └── page.tsx
├── lib/
│   ├── calculations.ts
│   ├── constants.ts
│   └── distance.ts
└── public/
    └── foam-king-logo.png

Important Notes

• All prices exclude VAT unless specified
• The calculator provides estimates only - final quotes require on-site inspection
• Focus on Zealand, Lolland-Falster, and Funen regions
• The domain beregner.foamking.dk points to 185.158.133.1