Skip to content

HappyDevs1/cheapies_corner

Repository files navigation

🚛 Cheapies Corner

A Modern Trucking Dealership Website

Netlify Status Live Demo TypeScript Next.js Tailwind CSS


📖 Project Description

Cheapies Corner is a modern, responsive trucking dealership website that provides an intuitive platform for browsing and purchasing commercial vehicles. Built with cutting-edge web technologies, it offers a seamless user experience with dynamic routing, responsive design, and optimized performance.

🌐 Live Demo: cheapies-corner.netlify.app


✨ Key Features

  • 🚀 Modern UI/UX - Clean, professional design with smooth animations
  • 📱 Fully Responsive - Optimized for desktop, tablet, and mobile devices
  • 🛣️ Dynamic Routing - Seamless navigation with Next.js App Router
  • 🎨 Component-Based Architecture - Reusable and maintainable React components
  • Performance Optimized - Fast loading times with Next.js optimizations
  • 🔍 SEO Ready - Search engine optimized for better visibility
  • 🎯 Type Safety - Full TypeScript implementation for robust development
  • 📦 Modern Icons - Lucide React icons for consistent visual elements

🛠️ Tech Stack

Technology Version Purpose
Next.js ^14.x React framework with SSR/SSG capabilities
TypeScript ^5.x Type-safe JavaScript development
Tailwind CSS ^3.x Utility-first CSS framework
React ^18.x Component-based UI library
Lucide React ^0.x Modern icon library
ESLint ^8.x Code linting and formatting

📁 Project Structure

chepies_corner/
├── 📁 public/                 # Static assets
│   ├── images/               # Image assets
│   └── favicon.ico          # Site favicon
├── 📁 src/                   # Source code
│   ├── 📁 app/              # Next.js App Router
│   │   ├── components/      # Reusable UI components
│   │   ├── globals.css      # Global styles
│   │   ├── layout.tsx       # Root layout component
│   │   └── page.tsx         # Home page
│   └── 📁 types/            # TypeScript type definitions
├── 📄 .gitignore            # Git ignore rules
├── 📄 eslint.config.mjs     # ESLint configuration
├── 📄 next.config.ts        # Next.js configuration
├── 📄 package.json          # Project dependencies
├── 📄 postcss.config.mjs    # PostCSS configuration
├── 📄 tailwind.config.ts    # Tailwind CSS configuration
└── 📄 tsconfig.json         # TypeScript configuration

🚀 Setup Instructions

Prerequisites

  • Node.js (v18.0.0 or higher)
  • npm or yarn package manager
  • Git for version control

Installation

  1. Clone the repository

    git clone https://github.com/HappyDevs1/cheapies_corner.git
    cd cheapies_corner
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Run the development server

    npm run dev
    # or
    yarn dev
  4. Open your browser Navigate to http://localhost:3000 to see the application.

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
npm run lint:fix # Fix linting issues automatically

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

How to Contribute

  1. Fork the repository

    gh repo fork HappyDevs1/cheapies_corner
  2. Create a feature branch

    git checkout -b feature/amazing-feature
  3. Make your changes

    • Follow the existing code style
    • Add tests if applicable
    • Update documentation as needed
  4. Commit your changes

    git commit -m "feat: ✨ add amazing feature"
  5. Push to your branch

    git push origin feature/amazing-feature
  6. Open a Pull Request

    • Provide a clear description of changes
    • Reference any related issues
    • Ensure all checks pass

Contribution Guidelines

  • 📝 Use Conventional Commits for commit messages
  • 🧪 Write tests for new features
  • 📚 Update documentation for significant changes
  • 🎨 Follow the established code style (ESLint + Prettier)
  • 🐛 Report bugs with detailed reproduction steps

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2025 HappyDevs1

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

🌟 Acknowledgments

  • 🎨 Icons provided by Lucide React
  • 🖼️ Images optimized with Next.js Image component
  • 🚀 Deployed with Netlify
  • 💪 Built with love by HappyDevs1

📞 Contact & Support


Made with ❤️ by HappyDevs1

⭐ Star this repository if you found it helpful!

About

A trucking dealership website built using Next.js (TypeScript) featuring Tailwindcss for styling

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published