Skip to content

AseemPrasad/circularfashion

Repository files navigation

git checkout -b feature-name git commit -m "feat: added material impact dashboard UI"

👗♻️ Circular Fashion Solutions

AI-Powered Sustainable Material Selection Platform


🌱 Project Overview

Circular Fashion is an AI-driven platform designed to help the fashion industry make sustainable, data-driven, and transparent material choices. Our mission is to empower designers, developers, and brands to create a circular, low-waste, and eco-conscious future for fashion.


✨ Features

  • AI-Powered Material Recommendations: Get suggestions for sustainable fabrics based on durability, water usage, recyclability, and emissions.
  • Material Impact Dashboard: Visualize energy, water, emissions, and lifecycle stats for materials.
  • Blockchain Material Passport: Build transparent supply chains with decentralized verification (planned).
  • Sustainability Scoring System: Compare eco-impact across materials with a 0–100 scoring system.
  • Dynamic Pages & Modular UI: Home, Auth, Profile, Feedback, About, and more.
  • Community Driven: Open for contributions, events, and workshops.

🚀 Quick Start

Try the live demo:

circularfashion.vercel.app

Or clone the repository and start the development server:

git clone https://github.com/AseemPrasad/circularfashion.git
cd circularfashion
npm install
npm run dev

Open http://localhost:5173 in your browser.


🧩 Technology Stack

Category Technologies
Frontend React, TypeScript, Vite, TailwindCSS
Routing React Router
Icons Lucide React
Styling Tailwind CSS, Custom CSS
Future Backend Node.js (optional)
Future Features AI APIs, Blockchain Integrations

📁 Folder Structure

circularfashion/
├── src/
│   ├── components/      # Reusable UI components (Navbar, Footer)
│   ├── pages/           # Main pages (Home, Auth, Profile, Feedback, About)
│   ├── App.tsx          # Main app layout and routing
│   ├── main.tsx         # App entry point
│   └── index.css        # Global styles
├── public/              # Static assets
├── assets/              # Images, screenshots, etc.
├── package.json         # Project metadata and scripts
├── README.md            # Project documentation
├── ...                  # Configs (Vite, Tailwind, TypeScript)

🤝 Contribution Guidelines

We welcome contributors of all skill levels! To get started:

  1. Fork the repository
  2. Create a new branch
    git checkout -b feature-name
  3. Build your feature following the structure under /src, /assets, /public
  4. Commit with meaningful messages
    git commit -m "feat: add material impact dashboard UI"
  5. Open a Pull Request and explain:
    • What you added
    • Why it helps
    • (Optional) Attach screenshots

See CONTRIBUTING.md and CODE_OF_CONDUCT.md for more details.


📌 Good First Issues

  • Add new sustainability challenges
  • Create UI components
  • Fix animations or layout
  • Write JSON-driven modules
  • Add new data for material scoring
  • Improve page navigation
  • Add events, announcements, or workshops
  • Write documentation

🗺️ Roadmap

Phase 1 — UI & Pages

  • Material browsing UI
  • Impact score cards
  • Blockchain passport placeholder page

Phase 2 — Data & Intelligence

  • Material lifecycle dataset integration
  • Sustainability scoring model
  • Python data-analysis practice modules

Phase 3 — Transparency & Impact

  • Blockchain verification
  • Material tracking timeline
  • CO₂ + water impact visualizer

📄 License

License information will be added soon.

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •