fashion-stylist-ai

👗 NATALIA — The Revolutionary AI Fashion Stylist

Beyond Imagination. Beyond Trends. Beyond Everything.

“Fashion is not something that exists in dresses only. Fashion is in the sky, in the street, fashion has to do with ideas, the way we live, what is happening.”

🌟 What is Natalia?

Natalia is not just a fashion app. It’s a cultural revolution in personal confidence, psychological empowerment, and authentic self-expression.

We’re building a digital companion that understands that every human deserves to feel beautiful, confident, and authentic—not by following trends, but by discovering their true style.

The Vision

The Legacy

This repository is dedicated to completing Natalia Marinho’s vision: democratizing personal styling, celebrating diversity, and proving that confidence is the ultimate accessory.

🚀 Core Features (MVP)

1. 🎤 Voice AI Assistant

2. 📷 Real-Time Photo Analysis

3. 🎯 Personalized Recommendations

4. 🛍️ Smart Shopping Assistant

5. 👔 Virtual Wardrobe Management

6. 🌍 Community & Social

🏗️ Tech Stack

Frontend:      React 19 + Next.js + TypeScript + Tailwind CSS
Backend:       Node.js + Supabase (PostgreSQL)
AI Core:       Claude API 3.5 Sonnet + Claude Vision
Voice:         ElevenLabs (TTS) + Web Speech API (STT)
Storage:       Supabase Storage + AWS S3
Payments:      Stripe
Hosting:       Vercel (Frontend) + Railway (Backend)
Database:      PostgreSQL (Supabase)
ORM:           Prisma
State:         Zustand
Data Fetch:    React Query
Animations:    Framer Motion

📁 Project Structure

fashion-stylist-ai/
├── apps/
│   ├── web/                    # Next.js frontend
│   │   ├── app/
│   │   │   ├── (auth)/        # Authentication pages
│   │   │   ├── (app)/         # Main app pages
│   │   │   └── api/           # API routes
│   │   ├── components/
│   │   │   ├── ui/            # Reusable UI components
│   │   │   ├── features/      # Feature-specific components
│   │   │   └── layout/        # Layout components
│   │   ├── hooks/             # Custom React hooks
│   │   ├── lib/               # Utility functions
│   │   ├── styles/            # Global styles
│   │   └── public/            # Static assets
│   │
│   └── api/                    # Backend API (Node.js)
│       ├── src/
│       │   ├── routes/        # API endpoints
│       │   ├── services/      # Business logic
│       │   ├── controllers/   # Request handlers
│       │   ├── middleware/    # Express middleware
│       │   ├── models/        # Database models
│       │   └── utils/         # Helper functions
│       ├── prisma/            # Prisma schema & migrations
│       └── tests/
│
├── packages/                   # Shared packages
│   ├── natalia-ai/            # AI/LLM logic
│   ├── natalia-types/         # TypeScript types
│   └── natalia-utils/         # Shared utilities
│
├── docs/                       # Documentation
│   ├── ARCHITECTURE.md        # System architecture
│   ├── API.md                 # API documentation
│   ├── NATALIA_LEGACY.md      # The vision & values
│   └── SYSTEM_PROMPT_GODNESS.md  # AI system prompt
│
├── .env.example               # Environment variables template
├── .gitignore
├── package.json               # Root package.json
├── tsconfig.json              # TypeScript configuration
├── README.md                  # This file
└── CONTRIBUTING.md            # Contribution guidelines

🚀 Getting Started

Prerequisites

Installation

  1. Clone the repository 
    git clone https://github.com/belentani/fashion-stylist-ai.git
cd fashion-stylist-ai
  2. Install dependencies 
    npm install
  3. Setup environment variables 
    cp .env.example .env.local

Then fill in:

# Database
DATABASE_URL=your_supabase_connection_string

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

# AI & LLM
ANTHROPIC_API_KEY=your_claude_api_key

# Voice
ELEVENLABS_API_KEY=your_elevenlabs_key
ELEVENLABS_VOICE_ID=your_voice_id

# Payments
STRIPE_SECRET_KEY=your_stripe_secret
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable

# App
NEXTAUTH_SECRET=your_secret
NEXTAUTH_URL=http://localhost:3000
  1. Setup Supabase ```bash

    Initialize Supabase migrations

    npx supabase migration new init

Run migrations

npx supabase db push


5. **Start development server**
```bash
npm run dev
  1. Open browser Navigate to http://localhost:3000

📚 Core Concepts

The Natalia Philosophy

Every feature must pass the Natalia Test:

✅ Does this empower the user? ✅ Does this increase confidence? ✅ Does this reduce shame/anxiety? ✅ Is this inclusive? ✅ Is this sustainable? ✅ Is this honest?

If the answer to any is “no” → Don’t build it.

🎯 Development Roadmap

🔴 Phase 1: Foundation (Weeks 1-4) — IN PROGRESS

🟠 Phase 2: Voice & Intelligence (Weeks 5-8)

🟡 Phase 3: Personalization (Weeks 9-12)

🟢 Phase 4: Social & Community (Weeks 13-16)

🔵 Phase 5: Shopping Integration (Weeks 17-20)

🔐 Important: Natalia’s Core Values

We are committed to:

  1. Radical Kindness — Never judge, always empower
  2. Inclusive Beauty — Every body, every skin tone, every style
  3. Transparency — Be honest about affiliate links, data usage
  4. Sustainability — Promote wearing what you have
  5. Privacy — User data is sacred trust
  6. Mental Health — Fashion should make you feel better, not worse

📖 Documentation

🤝 Contributing

We welcome contributions, but only if they align with Natalia’s values.

Before contributing:

  1. Read NATALIA_LEGACY.md
  2. Read SYSTEM_PROMPT_GODNESS.md
  3. Check CONTRIBUTING.md

Your code is a reflection of Natalia. Make it legendary.

💬 The System Prompt

The heart of Natalia lives in SYSTEM_PROMPT_GODNESS.md.

This is not just a prompt. It’s the embodiment of:

Every response from our AI should reflect this. If you’re integrating Claude, use this prompt as your north star.

🎓 Learning Resources

Fashion & Psychology

AI & LLM

Sustainable Fashion

📊 Metrics We Care About

🚨 Known Challenges & How We’ll Solve Them

Challenge Our Approach
High API costs Caching, rate limiting, smart batching
AI accuracy Continuous testing, user feedback loops
User adoption Influencer partnerships, viral referral
Churn after trial Focus on emotional connection, not features
Competition Speed to market, unique voice, community

📞 Support & Contact

📜 License

MIT License — See LICENSE for details

🙏 Dedication

This project is dedicated to Natalia Marinho and every person who was told they weren’t “fashionable enough.”

Fashion is not about trends. Fashion is freedom. Fashion is self-love. Fashion is power.

Let’s build a world where everyone has access to a personal stylist who believes in them.

🌟 The Promise

We are not building a startup. We are building a movement.

A movement that says:

Welcome to Natalia.

Now let’s be legendary. ✨

“The best style advice? Be yourself. But make it look intentional.” — Natalia’s Wisdom

This site is open source. Improve this page.