Hi everyone! 👋

I’d like to share a project I’ve been building called CrustAI.

The idea came from a very common problem I kept facing as a developer:
understanding unfamiliar repositories and writing good technical documentation takes time — sometimes a lot of time.

So I decided to experiment with a React-based application that uses AI to analyze a repository and automatically generate structured documentation from it.

🚀 What the app does

You provide a repository, and the app:

• Analyzes the project structure
• Understands the technologies involved
• Generates human-readable documentation
• Helps developers quickly understand unknown codebases

🧠 Technical stack

The project was built mainly to explore architecture and patterns in React for AI-driven apps:

• React + Vite
• Component-driven architecture
• API integration with AI services
• Clean state management
• Focus on scalability and maintainability

One of my goals was to structure the frontend in a way that could easily scale into a SaaS product in the future.

💡 What I learned building this

This project taught me a lot about:

• Designing React apps that interact with AI APIs
• Handling async flows and user feedback properly
• Organizing components for complex UI states
• Thinking about UX when the output is AI-generated content
• Structuring a project as if it were a real product, not just a demo

🔍 I would love feedback on

• Project structure
• Component organization
• UX decisions
• Possible improvements
• Anything you would refactor

Here is the repository if you’d like to take a look:

👉 https://github.com/DaveSimoes/CrustAI

Thanks a lot! 🙏
I’m open to any suggestions or critiques.