Skip to content

MasteraSnackin/CraftKicks1

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CraftKicks AI - Artisan Sneaker Studio

CraftKicks AI TypeScript React

CraftKicks AI is a professional, multimodal sneaker design studio that bridges the gap between digital innovation and traditional shoemaking. Transform your inspiration (images and text) into photorealistic sneaker designs while gaining educational "Craft Insights" from the perspective of a master Italian cobbler.

🌟 Live Demo

Try CraftKicks AI Now

Experience the full application in your browser

Launch CraftKicks AI

Click the button above to open the interactive CraftKicks AI studio

Features you can explore:

  • ✨ Upload inspiration images or describe your design
  • 🎨 Generate 4-angle photorealistic sneaker views
  • ✏️ Refine designs with natural language commands
  • πŸ“š Learn traditional shoemaking techniques
  • πŸ’Ύ Export high-quality designs

πŸŽ₯ Demo Video

Watch CraftKicks AI in Action

Transform your sneaker ideas into professional designs with AI-powered creativity

Recording.2026-01-24.232830.mp4


✨ Key Features

  • Multimodal Inspiration Pipeline: Upload moodboards, textures, or silhouettes to guide the AI's aesthetic.
  • 4-Angle Studio View: Generates high-fidelity photorealistic views (Side, Front, Rear, Top) for a complete design perspective.
  • Refinement Studio: Iteratively refine designs using natural language (e.g., "make the sole thicker", "use gold accents").
  • Artisan Education: Automatically generates detailed shoemaking specifications, traditional construction methods (Goodyear welt, Blake stitch, etc.), and step-by-step artisan processes.
  • User Authentication & Persistence: Built-in profile system to save your designs, inspiration history, and selected themes.
  • Export Capabilities: High-quality PNG downloads for all generated design angles.

πŸ–ΌοΈ Design Showcase

Experience the CraftKicks Studio

Photorealistic sneaker designs powered by AI innovation and traditional craftsmanship

CraftKicks Side View
Side Profile View
Complete lateral perspective with material details
CraftKicks Multiple Angles
  <br />

4-Angle Studio View
image Front, Rear, Top, and Side perspectives

Each design includes detailed construction specifications and artisan insights


πŸ—οΈ Technical Architecture

πŸ“Š Sequence Diagram

The following diagram illustrates the user interaction flow through the CraftKicks AI application:

image

πŸ”„ Data Flow Diagram

This diagram shows how data flows through the CraftKicks AI system: image

πŸ—οΈ Component Architecture Diagram

This diagram shows the React component hierarchy and structure:

graph TD
    A[App.tsx] --> B[Header]
    A --> C[Main Container]
    A --> D[Footer]
    
    C --> E[Upload Section]
    C --> F[Design Studio]
    C --> G[Craft Insights Panel]
    
    E --> E1[Image Upload]
    E --> E2[Text Input]
    E --> E3[Generate Button]
    
    F --> F1[4-View Display]
    F --> F2[Refinement Controls]
    F --> F3[Export Options]
    
    F1 --> F1a[Side View Canvas]
    F1 --> F1b[Front View Canvas]
    F1 --> F1c[Rear View Canvas]
    F1 --> F1d[Top View Canvas]
    
    F2 --> F2a[Natural Language Input]
    F2 --> F2b[Preset Modifications]
    F2 --> F2c[Apply Changes Button]
    
    F3 --> F3a[Download PNG]
    F3 --> F3b[Save to Library]
    F3 --> F3c[Share Design]
    
    G --> G1[Construction Methods]
    G --> G2[Material Specifications]
    G --> G3[Quality Indicators]
    G --> G4[Artisan Tips]
    
    style A fill:#ff6b9d
    style C fill:#00d4ff
    style F fill:#ffd93d
    style G fill:#6bcf7f
Loading

🌐 System Architecture Diagram

High-level overview of the system components and their interactions:

graph LR
    subgraph Client["Client Layer"]
        UI[React Frontend]
        State[State Management]
        Local[Local Storage]
    end
    
    subgraph API["API Layer"]
        Vision[Vision API]
        Generation[Image Generation API]
        Text[Text Generation API]
    end
    
    subgraph Services["External Services"]
        AI[AI Model Services]
        CDN[Content Delivery]
        Analytics[Analytics]
    end
    
    UI --> State
    State --> Local
    
    UI --> Vision
    UI --> Generation
    UI --> Text
    
    Vision --> AI
    Generation --> AI
    Text --> AI
    
    UI --> CDN
    UI --> Analytics
    
    Local -.->|Persist| UI
    AI -.->|Results| Vision
    AI -.->|Results| Generation
    AI -.->|Results| Text
    
    style Client fill:#e3f2fd
    style API fill:#fff3e0
    style Services fill:#f3e5f5
    style UI fill:#00d4ff
    style AI fill:#ff6b9d
Loading
  • Frontend: React (ES6 Modules) with Tailwind CSS for high-performance, responsive UI.
  • AI Core: Advanced multimodal AI for vision analysis, image generation, and technical text generation.
  • State Management: React Hooks with local persistence for user sessions and design archives.
  • Icons: Lucide React.
  • Aesthetics: Premium dark-mode studio interface with high-contrast electric blue and coral accents.

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ and npm
  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • API key for AI services (see Configuration section)

Installation

# Clone the repository
git clone https://github.com/MasteraSnackin/CraftKicks.git
cd CraftKicks

# Install dependencies
npm install

# Start the development server
npm run dev

Configuration

  1. Create a .env file in the root directory
  2. Add your API configuration:
VITE_API_KEY=your_api_key_here

πŸ“– Usage

  1. Upload Inspiration: Start by uploading images or entering text descriptions of your desired sneaker design
  2. Generate Design: Click "Generate" to create your custom sneaker in 4 photorealistic angles
  3. Refine: Use natural language commands to iteratively improve your design
  4. Learn: Read the "Craft Insights" to understand traditional shoemaking techniques
  5. Export: Download your final designs in high-quality PNG format

🎨 Design Philosophy

CraftKicks AI combines cutting-edge AI technology with respect for traditional craftsmanship. Each generated design includes educational content about:

  • Construction Methods: Goodyear welt, Blake stitch, cement construction
  • Materials: Leather types, synthetic alternatives, sustainable options
  • Quality Indicators: What separates premium footwear from mass production
  • Artisan Techniques: Hand-stitching, burnishing, patina application

πŸ“ Project Structure

CraftKicks/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ App.tsx              # Main application component
β”‚   β”œβ”€β”€ index.tsx            # Application entry point
β”‚   β”œβ”€β”€ types.ts             # TypeScript type definitions
β”‚   β”œβ”€β”€ constants.tsx        # Application constants
β”‚   └── services/
β”‚       └── gemini.ts        # AI service integration
β”œβ”€β”€ index.html               # HTML entry point
β”œβ”€β”€ package.json             # Project dependencies
β”œβ”€β”€ tsconfig.json            # TypeScript configuration
β”œβ”€β”€ vite.config.ts          # Vite build configuration
└── README.md               # This file

πŸ”§ Development

Build for Production

npm run build

Run Tests

npm test

Linting

npm run lint

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

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

πŸ™ Acknowledgments

  • Inspired by traditional Italian shoemaking craftsmanship
  • Built with modern web technologies for optimal performance
  • Designed for both sneaker enthusiasts and professional designers

πŸ“ž Contact

For questions, suggestions, or collaborations:


Made with ❀️ for sneaker culture and artisan craftsmanship

About

A professional sneaker design studio that transforms user inspiration into custom sneaker designs using AI

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors