Skip to content

CLAUDE.md

Latest commit

 

History

History
82 lines (63 loc) · 3.81 KB

CLAUDE.md

File metadata and controls

82 lines (63 loc) · 3.81 KB

CLAUDE.md

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

Backup Location

The original full website pages are backed up in backup-pages/ directory:

  • backup-pages/pages/ - All original page files (index, about, blog, contact, features, pricing, integrations, 404)
  • backup-pages/pages/blog/ - Blog dynamic route files
  • backup-pages/layouts/ - Original layout files
  • backup-pages/components/ - Original component files

To restore the full site:

cp backup-pages/pages/*.astro src/pages/
cp backup-pages/pages/blog/*.astro src/pages/blog/

Development Commands

  • Development server: pnpm dev or npm run dev
  • Production build: pnpm build or npm run build
  • Production server: pnpm start or npm run start
  • Linting: pnpm lint or npm run lint

Architecture Overview

This is a Next.js 15 application built with TypeScript, focusing on technology consulting services (Bitropy). Key architectural patterns:

Content Management

  • Articles system: MDX-based articles stored in content/articles/ with frontmatter metadata
  • Content processing: lib/mdx.ts handles article parsing, sorting, and filtering using gray-matter and marked
  • Dynamic routing: Articles use Next.js dynamic routes at app/articles/[slug]/page.tsx

UI Framework

  • Design system: Tailwind CSS with shadcn/ui components
  • Component structure: Reusable UI components in components/ui/
  • Layout components: Header/Footer in components/layout/
  • Theming: CSS custom properties for consistent styling

Core Features

  • Contact forms: API endpoint at app/api/contact/route.ts with Resend integration
  • Social sharing: ShareButtons component with LinkedIn integration and dynamic Open Graph meta tags
  • Analytics: Google Analytics integration via GoogleAnalytics component
  • SEO optimization: Comprehensive metadata in root layout
  • Client showcase: Client logos displayed on homepage in /public/logos/ directory using Next.js Image component

Configuration Notes

  • Build settings: ESLint and TypeScript errors ignored during builds (see next.config.mjs)
  • Images: Unoptimized images enabled for static deployment
  • MDX support: Configured with @next/mdx and experimental mdxRs feature
  • Path aliases: @/* mapped to root directory in tsconfig.json

Styling Approach

  • Uses Tailwind with extensive custom color palette via CSS variables
  • Light theme consistency: All pages use light theme with bg-white, text-gray-900 for readability
  • Purple accent colors (text-purple-600, bg-purple-50) for branding consistency
  • Includes animations and custom keyframes for UI interactions
  • Responsive design patterns throughout components
  • Client logos use grayscale filters with hover effects for professional appearance

AI Team Configuration (autogenerated by team-configurator, 2025-08-10)

Important: YOU MUST USE subagents when available for the task.

Detected Technology Stack

  • Frontend Framework: Next.js 15 with React 19 and TypeScript 5
  • Styling: Tailwind CSS with shadcn/ui component system
  • Content Management: MDX with gray-matter and marked for article processing
  • UI Components: Extensive Radix UI primitives with custom theming
  • Email Service: Resend API for contact form handling
  • Internationalization: Built-in i18n with Polish translation support
  • Package Manager: pnpm with lockfile management
  • Build Tools: PostCSS, ESLint (development only), TypeScript compiler
  • State Management: React hooks with form handling via react-hook-form + zod
  • Analytics: Google Analytics integration
  • Deployment: Static-friendly configuration with unoptimized images

EOF < /dev/null

  • use pnpm lint as linter or delegate to @agent-lint-fix-enforcer