# rushyendra28/resace architecture

> Architecture diagram of the GitHub repository rushyendra28/resace, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rushyendra28/resace
- Repository: https://github.com/rushyendra28/resace

## Overview

##### Project type and purpose
- From the file tree and README, we see:
- A Next.js 13 application (next.config.ts, src/app, page.tsx, layout.tsx)
- UI components under src/components/ui, styled with Tailwind (tailwind.config.ts, postcss.config.mjs)
- AI-driven “flows” under src/ai (ATS analysis, resume improvement, skill recommendations)
- A PDF parsing service under src/services/pdf-parser.ts
- It relies on Firebase for hosting/auth/data (not shown directly but alluded to as “firebase studio project”)
- Purpose: let users upload a resume (PDF), parse it, score / enrich it via AI flows, and match it to job descriptions.

##### File structure
- Top-level:
- src/app – Next.js route-based pages/server components
- src/components/ui – Design system primitives (buttons, dialogs, menus)
- src/ai – Business logic for AI-driven features (ai-instance.ts, flows/*.ts)
- src/services – Utility modules (PDF parser)
- src/lib – Generic utilities (utils.ts)
- src/hooks – React hooks for toast, mobile detection
- No self-hosted backend; it’s a front-end app that calls external services (AI provider, Firebase SDK).

##### README for additional insights
- A brief intro: “A firebase studio project… check resume score and job match… see src/app/page.tsx.”

##### Final checklist
- All components named and boxed separately
- Data flows shown with arrowheads and brief labels
- Critical config files (e.g., .env for Firebase keys) if relevant to deployment context

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend (Next.js)"
        FE["Next.js Frontend\n(src/app)"]:::internal
        UI["Design System & UI Components\n(src/components/ui)"]:::ui
        Hooks["React Hooks\n(src/hooks)"]:::ui
        Utils["Utility Functions\n(src/lib/utils.ts)"]:::internal
        Config["Next.js Configuration\n(next.config.ts)"]:::config
        Tailwind["Tailwind & PostCSS\n(tailwind.config.ts\npostcss.config.mjs)"]:::config
        Env["Environment Variables\n(.env)"]:::config
        Metadata["Project Metadata\n(package.json,\npackage-lock.json,\ntsconfig.json)"]:::config
        Docs["Documentation\n(docs/blueprint.md)"]:::config
    end

    subgraph "Business Logic"
        Parser["PDF Parser Service\n(src/services/pdf-parser.ts)"]:::service
        AIInst["AI Instance Wrapper\n(src/ai/ai-instance.ts)"]:::ai
        DevConf["AI Dev Config\n(src/ai/dev.ts)"]:::ai
        subgraph "AI Workflow Engine"
            ATS["ATS Analysis Flow\n(src/ai/flows/ats-analysis.ts)"]:::ai
            Improve["Resume Improvement Suggestions Flow\n(src/ai/flows/resume-improvement-suggestions.ts)"]:::ai
            Skills["Skill Recommendations Flow\n(src/ai/flows/skill-recommendations.ts)"]:::ai
        end
    end

    subgraph "External Services"
        AIAPI["External AI API"]:::external
        FirebaseAuth["Firebase Auth"]:::external
        Firestore["Firestore"]:::db
        Hosting["Firebase Hosting"]:::external
    end

    FE -->|"upload PDF"| Parser
    Parser -->|"parsed text"| AIInst
    FE -->|"invoke AI workflows"| AIInst
    AIInst -->|"orchestrates"| ATS
    AIInst -->|"orchestrates"| Improve
    AIInst -->|"orchestrates"| Skills
    AIInst -->|"calls API"| AIAPI
    AIAPI -->|"response"| AIInst
    FE -->|"login / SDK calls"| FirebaseAuth
    FE -->|"read/write"| Firestore
    Hosting -->|"hosts frontend"| FE

    classDef internal fill:#A6E3E9,stroke:#000;
    classDef ui fill:#C3FBD8,stroke:#000;
    classDef ai fill:#FDE2E4,stroke:#000;
    classDef service fill:#E2F0CB,stroke:#000;
    classDef config fill:#EEE5F2,stroke:#000;
    classDef external fill:#FFD6A5,stroke:#000;
    classDef db fill:#BEE3F8,stroke:#000;

    click FE "https://github.com/rushyendra28/resace/tree/master/src/app"
    click UI "https://github.com/rushyendra28/resace/tree/master/src/components/ui"
    click Hooks "https://github.com/rushyendra28/resace/tree/master/src/hooks"
    click Utils "https://github.com/rushyendra28/resace/blob/master/src/lib/utils.ts"
    click Config "https://github.com/rushyendra28/resace/blob/master/next.config.ts"
    click Tailwind "https://github.com/rushyendra28/resace/blob/master/tailwind.config.ts"
    click Tailwind "https://github.com/rushyendra28/resace/blob/master/postcss.config.mjs"
    click Env "https://github.com/rushyendra28/resace/blob/master/.env"
    click Metadata "https://github.com/rushyendra28/resace/blob/master/package.json"
    click Docs "https://github.com/rushyendra28/resace/blob/master/docs/blueprint.md"
    click Parser "https://github.com/rushyendra28/resace/blob/master/src/services/pdf-parser.ts"
    click AIInst "https://github.com/rushyendra28/resace/blob/master/src/ai/ai-instance.ts"
    click DevConf "https://github.com/rushyendra28/resace/blob/master/src/ai/dev.ts"
    click ATS "https://github.com/rushyendra28/resace/blob/master/src/ai/flows/ats-analysis.ts"
    click Improve "https://github.com/rushyendra28/resace/blob/master/src/ai/flows/resume-improvement-suggestions.ts"
    click Skills "https://github.com/rushyendra28/resace/blob/master/src/ai/flows/skill-recommendations.ts"
```
