Skip to content

IrfanCodesBTW/10kicks

Repository files navigation

10 Kicks Banner

👟 10 Kicks | Luxury Sneaker Archive

The definitive editorial street archive and premium e-commerce platform for rare kicks.

Build Status License Stars Forks

Live Demo · Report Bug · Request Feature


📖 Overview

10 Kicks is not just another sneaker store—it's a highly curated digital gallery for streetwear enthusiasts. Designed with a meticulous focus on typography, layout, and motion, it merges the world of high-end editorial magazines with modern e-commerce.

By leveraging cutting-edge web technologies, 10 Kicks delivers an immersive, ultra-fast, and buttery-smooth shopping experience.


✨ Why 10 Kicks?

  • 🎭 Editorial Aesthetics: A bespoke, mobile-first design language that treats every sneaker like a piece of art.
  • ⚡️ Blazing Fast: Powered by Vite & React 19 for instant page loads and zero layout shifts.
  • 🌊 Silky Motion: Custom GSAP animations combined with Lenis smooth scrolling for a premium, native-app feel.
  • 🧩 Modern Architecture: Fully typed, linted, and architected for scalable, component-driven development.

🛠 Tech Stack

Built with the best modern tools the frontend ecosystem has to offer.

Category Technology Description
Core React 19 & Vite The blazing fast foundation for our UI
Styling Tailwind CSS v4 Utility-first styling with custom global CSS properties
Motion GSAP & Lenis For complex choreographies and momentum scrolling
Routing React Router v7 Seamless client-side navigation
Icons Lucide React Beautiful, consistent iconography

🚀 Getting Started

Follow these steps to get a local instance of 10 Kicks running on your machine.

👉 View Installation Steps

Prerequisites

Make sure you have Node.js (v20+ recommended) installed.

1. Clone the repository

git clone https://github.com/10kicks/10kicks.git
cd 10kicks

2. Install dependencies

npm install

3. Start the dev server

npm run dev

Your local server will spin up at http://localhost:3000.


🚢 Deployment

10 Kicks is fully configured for zero-downtime deployments on the edge.

  • GitHub Pages: Automated deployment is configured via .github/workflows/pages.yml. Simply push to main!
  • Vercel / Netlify: Import the repository. The build command (npm run build) and output directory (dist) are automatically detected.

🤝 Join the Community

We're an open-source archive and welcome contributions from sneakerheads and developers alike.

  1. Fork the repository.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your Changes (git commit -m 'feat: add some AmazingFeature').
  4. Push to the Branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

Read our full Contributing Guidelines for more details.


Crafted with ❤️ by the 10 Kicks Team.

MIT License

About

A premium, front-end web application for a modern sneaker catalogue. Explore collections from top brands like Nike, Adidas, Puma, and Converse, add items to your cart, save them to your wishlist, and proceed through a sleek checkout flow.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors