Golden Eagle Construction & Remodeling

A modern, full-stack web application for Golden Eagle Construction & Remodeling, built with Next.js 15, TypeScript, and Prisma. This application serves as a comprehensive business platform showcasing construction services, managing projects, and handling customer inquiries.

🚀 Tech Stack

Frontend

• Next.js 15 - React framework with App Router
• React 19 - Latest React with concurrent features
• TypeScript 5 - Type-safe JavaScript
• Tailwind CSS 4 - Utility-first CSS framework
• GSAP - Professional animation library
• Lenis - Smooth scrolling library

Backend & Database

• Prisma 6 - Type-safe database ORM
• MySQL - Primary database
• Next.js API Routes - Server-side API endpoints
• Server Actions - Modern form handling

Infrastructure & Services

• AWS S3 - File storage and image hosting
• Vercel - Deployment and hosting platform
• Sentry - Error monitoring and performance tracking
• Upstash Redis - Rate limiting and caching

Development Tools

• ESLint - Code linting and formatting
• PostCSS - CSS processing
• Prisma Studio - Database management interface

📁 Project Structure

GoldenEagle/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (pages)/           # Main page routes
│   │   ├── (quicklinks)/      # Quick access routes
│   │   ├── admin/             # Admin dashboard routes
│   │   ├── api/               # API endpoints
│   │   ├── write/             # Dynamic content routes
│   │   ├── contexts/          # React contexts
│   │   ├── fonts/             # Custom font files
│   │   └── globals.css        # Global styles
│   ├── components/            # Reusable React components
│   │   ├── admin/             # Admin-specific components
│   │   └── ui/                # UI utility components
│   ├── constants/             # Application constants
│   ├── lib/                   # Utility libraries
│   │   ├── actions.ts         # Server actions
│   │   ├── prisma.ts          # Database client
│   │   ├── s3.ts              # AWS S3 utilities
│   │   ├── rateLimiter.ts     # Rate limiting logic
│   │   └── utils.ts           # Helper functions
│   └── types/                 # TypeScript type definitions
├── prisma/                    # Database schema and migrations
├── public/                    # Static assets
│   ├── assets/               # Image and video content
│   │   ├── Backdrops/        # Background images
│   │   ├── BathRoomRemodel/  # Service-specific content
│   │   ├── Concrete/         # Service-specific content
│   │   ├── CustomHome/       # Service-specific content
│   │   ├── Fences/           # Service-specific content
│   │   ├── KitchenRemodel/   # Service-specific content
│   │   ├── Painting/         # Service-specific content
│   │   ├── Patio/            # Service-specific content
│   │   └── Roofing/          # Service-specific content
│   └── Icons/                # SVG icons and logos
└── configuration files        # Various config files

🛠️ Key Features

Business Management

• Project Management - Track construction projects from inquiry to completion
• Customer Management - Handle project tickets and customer communications
• Service Catalog - Showcase different construction services
• Before/After Galleries - Visual project documentation
• Testimonials System - Customer feedback management

Admin Dashboard

• Content Management - Upload and manage images, videos, and content
• Project Tracking - Monitor project status and customer inquiries
• User Management - Admin authentication and role management
• Analytics - Track website performance and user engagement

Technical Features

• Responsive Design - Mobile-first approach
• Lazy Loading - Optimized content loading
• Image Optimization - Automatic image compression and delivery
• SEO Optimized - Search engine friendly structure
• Performance Monitoring - Sentry integration for error tracking

🚀 Getting Started

Prerequisites

• Node.js 18+
• MySQL database
• AWS S3 bucket
• Vercel account (for deployment)

Installation

1. Clone the repository

   git clone <repository-url>
   cd GoldenEagle

2. Install dependencies

   npm install

3. Environment Setup Create a .env.local file with:

   DATABASE_URL="mysql://user:password@localhost:3306/goldeneagle"
   AWS_S3_BUCKET_NAME="your-bucket-name"
   AWS_ACCESS_KEY_ID="your-access-key"
   AWS_SECRET_ACCESS_KEY="your-secret-key"
   AWS_REGION="us-east-2"
   JWT_SECRET="your-jwt-secret"
   UPSTASH_REDIS_REST_URL="your-redis-url"
   UPSTASH_REDIS_REST_TOKEN="your-redis-token"
   SENTRY_DSN="your-sentry-dsn"

4. Database Setup

   npx prisma generate
   npx prisma db push

5. Run Development Server

   npm run dev

6. Open Application Navigate to http://localhost:3000

📱 Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint
• npx prisma studio - Open database management interface

🗄️ Database Schema

The application uses a comprehensive database schema with the following main models:

• AuthenticatedUser - Admin user management
• ProjectTicket - Customer project inquiries
• CareerTicket - Job application management
• Image - Media asset management
• Testimonial - Customer feedback system
• Service - Construction service definitions

🎨 Styling & UI

• Tailwind CSS 4 for utility-first styling
• Custom CSS variables for consistent theming
• Responsive design with mobile-first approach
• GSAP animations for smooth interactions
• Lenis smooth scrolling for enhanced UX

🔒 Security Features

• JWT authentication for admin access
• Rate limiting to prevent abuse
• Input validation with Zod schemas
• Secure file uploads with type checking
• Environment variable protection

🚀 Deployment

Vercel Deployment

1. Connect your GitHub repository to Vercel
2. Configure environment variables in Vercel dashboard
3. Deploy automatically on push to main branch

Environment Variables Required

• Database connection string
• AWS S3 credentials
• JWT secret
• Redis connection details
• Sentry DSN for monitoring

📊 Monitoring & Analytics

• Sentry for error tracking and performance monitoring
• Vercel Analytics for user behavior insights
• Custom logging for business metrics

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is proprietary software for Golden Eagle Construction & Remodeling.

🆘 Support

For technical support or questions about the application, please contact the development team or refer to the internal documentation.

---

Built with ❤️ using Next.js 15, TypeScript, and modern web technologies