🔧 Refixly – AI + AR Powered DIY Repair Assistant

Refixly is an open-source web application that aims to empower users to repair household and electronic items using the power of AI and Augmented Reality (AR). With an intelligent front end, computer vision support, and planned AR overlays, Refixly aspires to become a go-to tool for real-time object detection, repair tutorials, and DIY community collaboration.

📊 Project Insights

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow Refixly! Let’s make learning and career development smarter – together! 🌟👨‍💻👩‍💻

👩‍💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

• ✨ Improve their skills
• 🤝 Contribute to impactful projects
• 🏆 Get recognized for their work
• 📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this Refixly project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

📑 Table of Contents

• 🎯 Project Vision
• 📦 Tech Stack Overview
• 📁 Project Structure
• 🚀 Getting Started
• 🧠 AI Model (Planned)
• 🌐 Live Demo
• 🧑‍💻 How to Contribute
• ✅ Guidelines
• 📄 License
• 🙌 Acknowledgements
• 📬 Contact

🎯 Project Vision

Refixly's ultimate goal is to allow users to:

• 📸 Detect broken objects using their webcam
• 🧠 Suggest fixes using AI
• 📹 Provide tutorial videos using YouTube API
• 🛠️ Guide users with AR overlays (planned)
• 🤝 Collaborate with others via a DIY community forum (planned)

This repository includes the homepage UI, the initial backend setup, and is open for community contributions.

📦 Tech Stack Overview

Here’s a complete breakdown of the technologies used (or planned) for Refixly.

🖥️ Frontend (React + Vite)

Tech	Purpose
React.js	Component-based UI development
Vite	Fast build tool and dev server for React
Tailwind CSS	Utility-first CSS framework for styling
React Router DOM	Routing and page navigation
WebRTC / MediaDevices API	Accessing webcam for live detection
TensorFlow.js	In-browser ML (e.g., object detection using COCO-SSD)

🛠️ Backend (Node.js + Express)

Tech	Purpose
Node.js	Server-side runtime environment
Express.js	Web framework to handle routes and APIs
MongoDB Atlas	Cloud NoSQL database for storing users, posts, and repair data
Mongoose	ODM for MongoDB to structure and manage data schemas
YouTube Data API v3	Fetch video tutorials based on object detection

🔐 Authentication (Planned)

Tech	Purpose
Firebase Auth	Secure user login (email/password, Google sign-in)

🕶️ AR Integration (Future Enhancement)

Tech	Purpose
Zappar WebAR SDK	Lightweight JavaScript AR overlay (WebXR-compatible)
8thWall	Commercial AR SDK (if free tier needed for advanced features)

📦 Dev Tools & Hosting

Tool/Service	Purpose
Vercel	Frontend hosting with GitHub CI/CD integration (free tier)
Render	Backend hosting for Node.js server (free tier)
Thunder Client / Postman	Local API testing

📁 Project Structure

refixly/
├── client/           # React Frontend (Vite)
│   ├── components/
│   ├── pages/
│   ├── assets/
├── server/           # Node.js + Express backend
│   ├── routes/
│   ├── controllers/
│   ├── models/
├── public/           # Static files (logo, manifest, favicon)
├── README.md
├── .env.example

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/yourusername/refixly.git
cd refixly

2. Setup Frontend

cd client
npm install
npm run dev

3. Setup Backend

cd ../server
npm install

4. Add Environment Variables

Create a .env file in /client:

VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
VITE_FIREBASE_PROJECT_ID=your_id
VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_id
VITE_MEASUREMENT_ID=your_measurement_id

Create a .env file in /server:

PORT=5000
MONGO_URI=your_mongodb_uri
YOUTUBE_API_KEY=your_youtube_api_key

5. Run Frontend Server

npm run dev

5. Run Backend Server

node server.js

🧠 AI Model (Planned)

We will use TensorFlow.js with COCO-SSD for in-browser object detection.

• No need for server-based inference
• Runs in user browser for speed and privacy
• Can be extended to YOLOv8 (with server hosting)

🌐 Live Demo

🔗 https://refixly.vercel.app

🧑‍💻 How to Contribute

We welcome open source contributors to build Refixly together!

📌 Contribution Steps:

• Fork this repository
• Create a branch: git checkout -b feature/your-feature-name
• Make your changes
• Commit: git commit -m "Added X feature"
• Push to your fork
• Create a Pull Request

📖 Good First Issues

Check the Issues tab for beginner-friendly contributions like:

*Add "About" or "Tutorials" pages

• Setup MongoDB models
• Create AR component placeholder
• Integrate TensorFlow.js

✅ Guidelines

• Follow consistent naming and code formatting
• Use comments where necessary
• Keep PRs focused and well-explained
• Respect the community — be kind and constructive ❤️

🙌 Acknowledgements

• React.js
• Tailwind CSS
• TensorFlow.js
• Zappar
• MongoDB Atlas
• Render
• Vercel
• Firebase

📬 Contact

• 🧑‍💻 Maintainer: Bavanetha M R
• 📧 Email: [email protected]

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to Refixly! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

🙌 Support & Star

If you find this project helpful, please give it a star ⭐ to support more such educational initiatives!

📄 License

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

⭐ Stargazers

🍴 Forkers

🧑‍💻Project Admin:

Bavanetha M.R

👨‍🏫 Mentors – Refixly (GSSoC'25)

Role	Name	GitHub Profile	LinkedIn Profile
Mentor 1	Pratyaksh	PRATYAKSH15	pratyaksh

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by Refixly Team

❤️ Bavanetha M.R and Contributors ❤️ open an issue | Watch Demo

Ready to show off your coding achievements? Get started with Refixly today! 🚀

🛠️ Refixly – Let’s fix the future, one repair at a time.

⬆️ Back to Top