Clever

The Smart CV Builder — AI-Powered Career Excellence

Clever is a premium, AI-driven resume builder designed to help job seekers create professional, ATS-optimized resumes in minutes. Built with Flutter, it offers a seamless cross-platform experience with deep AI integration for tailoring content to specific job descriptions.

English 🇺🇸 | Bahasa Indonesia 🇮🇩 | 🌐 Website

---

📺 Demo Video

---

⚠️ Portfolio Disclaimer

Important Notice for Developers & Recruiters:

This repository serves as a Personal Portfolio Showcase. While the frontend code is public to demonstrate architectural patterns, UI/UX design, and Flutter expertise, the project is not fully open-source in a turnkey sense:

1. Private Backend: Many features (AI Tailoring, Job Extraction, PDF Rendering) depend on a proprietary backend API hosted on Google Cloud Run.
2. Private Credentials: The .env file and Firebase configuration containing production keys are not included in this repository.
3. No Mocks (Yet): There is currently no local mock implementation to bypass the backend requirement. A "Playground Mode" with mocks is planned for future updates.

---

Features

• Advanced AI Tailoring: Automatically optimize every section of your CV for specific job postings using Gemini-powered logic.
• AI Job Extraction: Extract requirements and key skills directly from job URLs or raw text descriptions.
• 13+ Premium Templates: A diverse library of ATS-friendly, Modern, Creative, and Professional layouts.
• Master Profile: Manage your career data in one place—Experience, Education, Projects, and Skills.
• Real-time Analytics: Track your CV generation stats and career progress via the integrated dashboard.
• Concurrent Pre-generation: Smart performance optimization that triggers backend rendering while users engage with the app.
• Premium Wallet: Integrated subscription and credit system powered by RevenueCat.
• Interactive Onboarding: Guided walkthroughs to ensure users make the most of every feature.

---

Architecture

Clever uses an AI-driven strategy and a cloud-native infrastructure to deliver high-performance tailoring.

System Components

graph TD
    subgraph "Frontend (Flutter)"
        App["Clever App"]
        Local["Local Storage"]
    end

    subgraph "Backend (Node.js)"
        API["Express API (Cloud Run)"]
    end

    subgraph "AI Models"
        Gemini["Gemini (Vertex AI)"]
    end

    subgraph "Infrastructure"
        Firebase["Firestore / Auth"]
        GCS["Cloud Storage (PDFs)"]
    end

    App --> API
    API --> Gemini
    API --> Firebase
    API --> GCS

Loading

Data Pipeline Flow

sequenceDiagram
    participant User
    participant App as Clever App
    participant API as Backend API
    participant AI as Gemini

    User->>App: Input Profile & Job
    App->>API: POST /api/ai/cv/tailor
    Note over API: Firestore Cache Check
    API->>AI: Grounding (Company Context)
    AI-->>API: Summary
    API->>AI: Tailoring (XYZ Formula)
    AI-->>API: Tailored JSON
    API-->>App: Results + Analysis
    App->>API: POST /api/cv/generate
    API->>API: Render PDF (Puppeteer)
    API-->>App: GCS PDF URL

Loading

---

Quick Start

Prerequisites

• Flutter SDK ^3.10.1
• Dart ^3.0.0
• Android Studio / Xcode

Installation

1. Clone the repository

   git clone https://github.com/Amrlmlna/CleVer.git
   cd clever

2. Install dependencies

   flutter pub get

3. Note on Execution Running the app locally will result in functional boundaries unless you provide your own Firebase configuration and a compatible Backend API endpoint in a .env file.

---

Project Structure

lib/
├── core/
│   ├── constants/         # Design tokens, local data (regions, universities)
│   ├── router/           # GoRouter configuration
│   ├── services/         # External integrations (Payment, Analytics, AI)
│   └── theme/            # App branding & design system
├── domain/
│   ├── entities/         # Pure business logic objects
│   └── repositories/     # Abstract data contracts
├── data/
│   ├── models/           # DTOs and JSON serialization
│   ├── repositories/     # Repository implementations
│   └── datasources/      # Remote & Local data clients
└── presentation/
    ├── auth/             # User authentication flow
    ├── cv/               # CV editing & step-by-step creation
    ├── dashboard/        # Career insights & user metrics
    ├── home/             # Main landing & quick actions
    ├── jobs/             # Job extraction & analysis
    ├── notification/     # FCM handling & notification center
    ├── onboarding/       # Interactive feature walkthrough
    ├── profile/          # Master career profile management
    ├── templates/        # Premium template gallery
    └── wallet/           # Credits & subscription management

---

Development

Code Analysis

flutter analyze

Build Generation

The project uses riverpod_generator and json_serializable. To generate code:

flutter pub run build_runner build --delete-conflicting-outputs

---

Templates

Category	Best For	Templates Available
ATS-Friendly	Corporate & Large Firms	5 Layouts
Modern	Startups & Tech	4 Layouts
Creative	Design & Media	2 Layouts
Executive	Leadership Roles	2 Layouts

---

Roadmap

• Mock Playground: Local mock data to allow running the app without the private backend.
• Cover Letter AI: Fully automated, tailored cover letter generation.
• LinkedIn Integration: One-click profile import.
• Web Version: Responsive web dashboard for CV management.

---

Support

• Issues: GitHub Issues
• Developer: Amrlmlna

---

License

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