Skip to content

Anjan50/coverai

Repository files navigation

Philosophical Cover Letter Forge

A meditative web application for crafting cover letters infused with philosophical depth, inspired by the wisdom of thinkers like Naval Ravikant. Built with React.js and Vite, featuring a minimalist black-and-white aesthetic that evokes timeless wisdom and introspection.

🌟 Features

Philosophical Aesthetic

  • Minimalist Design: Clean black-and-white theme with subtle gray accents
  • Elegant Typography: Serif fonts (Playfair Display, EB Garamond) for headings and philosophical quotes
  • Grid System: Subtle grid lines visible on hover, creating a structured yet ethereal feel
  • Meditative Experience: Subtle animations and philosophical quotes throughout the interface

Core Functionality

  • LLM Integration: Support for OpenAI ChatGPT, Google Gemini, and Anthropic Claude
  • Data Organization: Raw JSON input transformed into structured, editable categories
  • Philosophical Prompts: Contextual guidance inspired by Naval Ravikant's wisdom
  • Rich Text Editing: Advanced editor for refining generated cover letters
  • PDF Export: Download cover letters with the same philosophical aesthetic

Workflow

  1. Essence Selection: Choose your preferred LLM and provide API key
  2. Raw Data Input: Share your experience in JSON format
  3. Data Organization: LLM structures your information into philosophical categories
  4. Refinement: Edit organized data with philosophical prompts
  5. Opportunity Input: Provide job description and custom instructions
  6. Letter Forge: LLM researches and generates a philosophical cover letter
  7. Final Refinement: Edit and download your cover letter as PDF

πŸš€ Getting Started

Prerequisites

  • Node.js (version 16 or higher)
  • npm or yarn
  • API keys for your chosen LLM provider

Installation

  1. Clone the repository

    git clone <repository-url>
    cd coverai
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173

Building for Production

npm run build

πŸ”§ Configuration

LLM API Keys

The application supports three LLM providers. You'll need to obtain API keys from:

Data Structure

Your JSON input should follow this structure:

{
  "philosophy": "Your worldview and approach to life and work...",
  "work": "Your professional journey and experience...",
  "projects": "Key projects and achievements...",
  "background": "Educational and personal history...",
  "skills": "Technical and soft skills..."
}

🎨 Design Philosophy

Aesthetic Principles

  • Monochrome Palette: Strictly black, white, and subtle grays
  • Typography Hierarchy: Serif fonts for philosophical elements, sans-serif for readability
  • Grid System: Visible grid lines that organize content with mathematical precision
  • Minimalist Approach: Every element serves a purpose, no decorative flourishes

Philosophical Integration

  • Naval Ravikant Inspiration: Focus on first principles, leverage, and personal sovereignty
  • Wisdom Language: UI text uses profound, sparse language
  • Meditative Experience: Subtle animations and philosophical quotes
  • Intentional Design: Every interaction is a meditation on purpose

πŸ—οΈ Architecture

Technology Stack

  • Frontend: React.js with Vite
  • Styling: CSS with custom properties and philosophical design system
  • Rich Text: React Quill for advanced editing
  • PDF Generation: jsPDF for document export
  • LLM Integration: Direct API calls to OpenAI, Google, and Anthropic

Component Structure

src/
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ AppWrapper.jsx          # Theme wrapper
β”‚   β”œβ”€β”€ LLMSelector.jsx         # API key management
β”‚   β”œβ”€β”€ DataInput.jsx           # JSON input and validation
β”‚   β”œβ”€β”€ DataOrganizer.jsx       # LLM data structuring
β”‚   β”œβ”€β”€ EditableGrid.jsx        # Grid-based data editing
β”‚   β”œβ”€β”€ JobInput.jsx            # Job description input
β”‚   β”œβ”€β”€ LetterGenerator.jsx     # LLM cover letter generation
β”‚   β”œβ”€β”€ LetterEditor.jsx        # Rich text editing
β”‚   └── DownloadButton.jsx      # PDF export
β”œβ”€β”€ utils/
β”‚   └── llmService.js           # LLM API integration
β”œβ”€β”€ App.jsx                     # Main application
└── App.css                     # Philosophical styling

πŸ”’ Privacy & Security

  • Local Storage: All data is stored locally in the browser
  • No Backend: No data is sent to external servers except LLM APIs
  • API Key Security: Keys are stored securely in localStorage
  • No User Accounts: Completely anonymous and private

🎯 Usage Guide

Step 1: Choose Your Essence

Select your preferred LLM provider and enter your API key. The application will remember your choice across sessions.

Step 2: Pour Forth Your Truth

Input your experience in JSON format. The application provides an example structure to guide you.

Step 3: Witness Organization

The LLM will analyze your raw data and organize it into philosophical categories with profound insights.

Step 4: Refine Your Essence

Edit each category with philosophical prompts guiding your refinement process.

Step 5: Share the Opportunity

Provide the job description and any custom instructions for the cover letter generation.

Step 6: Forge the Letter

The LLM will research the job deeply and craft a philosophical cover letter in Naval Ravikant's style.

Step 7: Preserve Your Declaration

Edit the generated letter and download it as a beautifully formatted PDF.

🌟 Philosophical Quotes

The application features rotating philosophical quotes such as:

  • "The cover letter is not a plea, but a declaration of inevitable fit."
  • "In the vast expanse of possibilities, this role calls to my core pursuit of creation."
  • "Words are the vessels of intention; let them carry your essence with precision."

🀝 Contributing

This project embraces the philosophy of collaborative wisdom. Contributions are welcome in the spirit of improving the meditative experience and philosophical depth of the application.

πŸ“„ License

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

πŸ™ Acknowledgments

  • Inspired by the philosophical wisdom of Naval Ravikant
  • Built with modern web technologies for a timeless experience
  • Designed for those who seek meaning in their professional journey

"Craft your essence into words that resonate with the cosmos of opportunity."

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published