The All-In-One AI Freelancer OS
Document creative projects • Generate 4-slide carousel decks • Manage clients • Issue PDF invoices • Track real-time payments • Discover live gig opportunities with AI roadmaps
- About
- Features
- Tech Stack
- Architecture
- Project Structure
- Getting Started
- Configuration
- Security
- How to Contribute?
- What's Next?
- License
- Acknowledgements
- Author & Founder
VASLKAAR (derived from Urdu: Vasl وصل = connection / coming together, Kaar کار = work / doer) is an all-in-one operating system engineered specifically for creative freelancers, graphic designers, video editors, and indie builders who juggle multiple clients, platforms, and income streams.
"I didn't build VASLKAAR as an abstract academic experiment. I built it because I was burning out trying to survive my own daily routine."
As a professional graphic designer, video editor, and 1st-year Software Engineering student at the Virtual University of Pakistan, my daily reality was intense:
- 💼 Managing 2 remote design jobs across international timezones.
- 🤝 Handling freelance client projects on Fiverr, Upwork, and direct WhatsApp referrals.
- 🎓 Keeping up with full-time university engineering coursework & exams.
- 🚀 Constantly learning and building skills in modern AI, coding, and creative tech.
At the end of an exhausting day juggling clients, deliverables, and lectures, the hardest part was never the creative design work itself — it was the operational chaos:
- The Post-Project Fatigue: Finishing an extensive brand identity for a client at 2:00 AM, but having zero energy left to write a 1,000-word Behance case study, craft viral LinkedIn hooks, or design multi-slide carousels.
- The 6-App Juggling Act: Losing client briefs in scattered WhatsApp chats, tracking unpaid invoices on messy spreadsheets, manually designing PDF bills, and hesitating to draft awkward payment reminders.
- The Growth Trap: Spending so much time on administrative friction that there was no bandwidth left to find high-paying gigs, enter hackathons, or map out real execution roadmaps.
I realized that millions of independent creators and freelancers across Pakistan and worldwide face this exact same wall every single day. VASLKAAR was born to connect every broken piece of the freelance journey into one seamless, private, and empowering OS.
Freelancers currently waste 40%+ of their working hours context-switching between 6 different disconnected tools:
- Case Studies & Portfolios: Writing long Behance narratives and LinkedIn hooks manually.
- Graphic Design: Spending hours recreating carousel slides in Canva or Figma.
- Client Management: Losing track of leads across WhatsApp, Upwork, and Fiverr.
- Invoicing & Payments: Using spreadsheets and manual PDF creators, following up on unpaid bills with awkward messages.
- Growth & Direction: Struggling to find high-paying gigs and actionable skill roadmaps.
VASLKAAR bridges the entire creative-to-business lifecycle in a unified, private, lightning-fast workspace. Powered by Groq's high-speed LLM engine and client-side vector graphics rendering, VASLKAAR turns raw design screenshots into complete Behance case studies, LinkedIn posts, 4-slide carousel graphic decks, professional PDF invoices, and automated client reminders in seconds.
- 🧬 Design DNA Profiling: Set your unique creative profile — choose from 11+ professions (Graphic Designer, UI/UX, Video Editor, 3D Artist, etc.), aesthetic styles, inspirations, and output language.
- 🌐 Multilingual AI Generation: Auto-writes in English, Urdu (اردو), Hindi (हिंदी), Punjabi (پنجابی), French (Français), Arabic (العربية), and Spanish (Español).
- 🎤 Built-in Voice Input: Speak instead of typing project briefs using browser-native Web Speech API.
- 🎨 Canvas Color Palette Extraction: Automatically extracts dominant hex codes from uploaded images via HTML5 Canvas.
- 📝 Multi-Format Output:
- Behance Case Study: Complete overview, design challenge, process, strategic solution, and full description with 1-click Behance Editor launcher.
- LinkedIn Post Variations: 3 viral formats (Short <150 chars, Medium ~300 chars, Long ~500 chars with hashtags) with 1-Click Publish to LinkedIn Composer.
- SEO & Accessibility Package: Behance tags, Google meta descriptions, and image alt text for every uploaded asset.
- 🖼️ Multi-Slide Carousel Deck Studio: Turn your project instantly into a 4-slide LinkedIn Document / Instagram carousel:
- Slide 1: Viral Hook & Cover (Project Title + Badge + Extracted Palette)
- Slide 2: The Challenge & Strategy (Core Problem + Strategic Solution)
- Slide 3: Visual Deliverables & Palette (Palette Swatches + Tools Used)
- Slide 4: Results & Call to Action (Key Metrics + Author Handle + CTA)
- 📐 3 Format Ratios: 1:1 Square (Feed), 4:5 Portrait (Carousel), 16:9 Banner (Cover).
- 🎭 4 Design Themes: ✨ Dark Gold (Luxury), ⚪ Minimal (Clean Editorial), 🌌 Cyber (Neon Modern), 🌿 Emerald (Warm Organic).
- 📥 High-Res Export: Download single slides or one-click "Download All 4 Slides (Deck)" in crisp 2.5x Retina PNG quality via
html2canvas.
- 🧑💼 Client CRM: Track clients across Fiverr, Upwork, LinkedIn, and Direct contracts with status badges (Active, On-Hold, Completed, Problem), notes, and 1-Click WhatsApp Direct Chat.
- 🧾 Professional Invoices & PDF Export: Dynamic line items, auto-numbering (
INV-001), multi-currency (PKR,USD,EUR,GBP), one-click branded PDF download (viajsPDF), and direct WhatsApp invoice sharing. - 💰 Payment Tracker & AI Reminders: Live financial metrics for Total Earned, Pending Payments, and Overdue Balances with automated polite WhatsApp reminder messages.
- 📊 One-Click CSV Export: Export client rosters, invoice ledgers, and payment history to CSV for Excel / Google Sheets bookkeeping.
- 💡 5-Category Ideas Lab: AI consultant tailored to your Design DNA for Portfolio Projects, Hackathon Concepts, 30-Day Income Boosts, High-Income Skills, and Passive Digital Products.
- 🎯 Opportunities Radar: AI-matched gigs and remote jobs scanning Upwork, Fiverr, LinkedIn, Devpost, Contra, and Wellfound.
- 🗺️ 3-Phase Execution Roadmaps: Step-by-step actionable roadmaps with free tool badges (
Figma,Canva,CapCut,GitHub) and direct YouTube masterclass tutorial links. - 🔗 Verified Live Deep-Search URLs: Zero broken or 404 links — every platform link leads directly to live filtered search results.
| Layer | Technologies |
|---|---|
| Frontend UI | HTML5, Tailwind CSS (CDN), Vanilla JavaScript (ES6+) |
| Icons & Typography | Lucide Icons, Plus Jakarta Sans, DM Sans |
| AI Engine & Inference | Groq SDK (openai/gpt-oss-120b, qwen/qwen3.6-27b) |
| Graphic Vector Rendering | html2canvas (2.5x Retina Scale Canvas-to-PNG Exporter) |
| PDF Generation | jsPDF (Client-Side Vector PDF Engine) |
| Voice Recognition | Web Speech API (SpeechRecognition / webkitSpeechRecognition) |
| Serverless Backend | Vercel Serverless Functions (api/generate.js, api/ideas.js) |
| Local Development | Node.js HTTP Proxy Server (server.js) |
| Data Storage | LocalStorage API (Zero-database, private, client-side persistence) |
| Deployment & Hosting | Vercel Global Edge Network |
+-----------------------------------------+
| USER BROWSER |
| Single Page App (Tailwind + Vanilla JS)|
+----+-------------------------------+----+
| |
+---------------------+-------------------------------+---------------------+
| | |
v v v
+-----------------------+ +-----------------------+ +--------------+
| Client-Side Engine | | LocalStorage Database | | Web Speech |
| - html2canvas (PNG) | | - vaslkaar_dna | | API (Voice) |
| - jsPDF (Invoices) | | - vaslkaar_projects | +--------------+
| - Canvas (Colors) | | - vaslkaar_clients |
+-----------+-----------+ | - vaslkaar_invoices |
| +-----------------------+
v
+-----------------------+
| Exported Files & PNGs |
+-----------------------+
^
| (POST JSON Payload)
v
+-------------------------------------------------------------------------------+
| VERCEL SERVERLESS EDGE API / NODE.JS |
| /api/generate (Case Studies) | /api/ideas (Growth Engine) |
+---------------------------------------+---------------------------------------+
|
v
+-----------------------------------+
| GROQ CLOUD API |
| - openai/gpt-oss-120b (Primary) |
| - qwen/qwen3.6-27b (Fallback) |
+-----------------------------------+
vaslkaar/
├── index.html # Complete SPA architecture (all screens, modals, & tabs)
├── css/
│ └── styles.css # Theme tokens, custom animations, artboard styles & scrollbars
├── js/
│ ├── app.js # SPA router, sidebar controller, toast system, tab switcher
│ ├── utils.js # Voice input, HTML5 Canvas color extraction, CSV exporter
│ ├── dna.js # Design DNA profiling (professions, languages, aesthetics)
│ ├── upload.js # Drag-drop file uploader, image resizer, form validator
│ ├── generate.js # Groq AI generation controller & step animation runner
│ ├── graphics.js # 4-Slide Graphic & Document Studio + html2canvas PNG exporter
│ ├── output.js # Multi-tab results renderer, clipboard & 1-click share triggers
│ ├── projects.js # Project gallery, detail modal & status manager
│ ├── crm.js # Client CRM manager, modal CRUD & WhatsApp chat launcher
│ ├── invoice.js # Invoice creator, jsPDF renderer & WhatsApp share engine
│ ├── payments.js # Revenue calculator & payment reminder engine
│ ├── ideas.js # Ideas Lab runner, verified URL resolver & roadmap drawer
│ ├── opportunities.js # Opportunities radar & live apply link generator
│ └── storage.js # Unified LocalStorage persistence layer
├── api/
│ ├── generate.js # Serverless API for Behance case studies, LinkedIn & SEO
│ └── ideas.js # Serverless API for Growth ideas, gigs & execution roadmaps
├── assets/
│ └── logo.png # VASLKAAR brandmark
├── server.js # Local development server with API proxying
├── vercel.json # Vercel deployment configuration
├── package.json # Node.js dependencies (`groq-sdk`, `dotenv`)
└── README.md # Complete project documentation
- Node.js (version 18.0 or higher)
- A free Groq Cloud API Key (Get one free at console.groq.com)
- Modern browser (Google Chrome, Microsoft Edge, Brave, Safari)
-
Clone the repository:
git clone https://github.com/Javeriaf19/vaslkaar.git cd vaslkaar -
Install dependencies:
npm install
-
Configure environment variables: Create a
.envfile in the root directory:GROQ_API_KEY=gsk_your_actual_groq_api_key_here
-
Start the local development server:
node server.js
-
Open your browser: Navigate to
http://localhost:3000to experience VASLKAAR.
| Variable | Required | Description |
|---|---|---|
GROQ_API_KEY |
Yes | Your Groq Cloud API Key for AI generation. Obtainable for free at console.groq.com. |
PORT |
No | Port for local dev server (Default: 3000). Configurable in server.js. |
Deploy directly to Vercel in seconds:
- Push your repository to GitHub.
- Connect your repo in the Vercel Dashboard.
- Under Settings → Environment Variables, add:
- Key:
GROQ_API_KEY - Value:
gsk_your_groq_api_key_here
- Key:
- Click Deploy.
- Client-Side Privacy First: All user files, client databases, invoice records, and financial earnings are stored strictly in client-side
localStorage. No sensitive client data is ever sold or permanently stored on external database servers. - API Key Protection: The Groq API key is stored securely in environment variables on the backend serverless layer (
api/generate.jsandapi/ideas.js) and is never exposed to the client-side JavaScript bundle. - Zero Malicious Dependencies: Clean, audit-free architecture built with zero heavy frameworks, eliminating client-side supply-chain attack vectors.
Contributions, issues, and feature requests are welcome!
- Fork the repository (
https://github.com/Javeriaf19/vaslkaar/fork). - Create your feature branch:
git checkout -b feature/AmazingFeature
- Commit your changes:
git commit -m "feat: Add AmazingFeature" - Push to the branch:
git push origin feature/AmazingFeature
- Open a Pull Request with a detailed summary of your changes.
- v1.1 — Cloud Sync & Auth: Optional Firebase Auth & Firestore cloud synchronization across multiple devices.
- v1.2 — Direct Social Publishing: OAuth 2.0 direct publishing to LinkedIn Company Pages and Twitter/X threads.
- v1.3 — WhatsApp Business Automation: Automated invoice sending via official Meta Cloud WhatsApp Business Webhooks.
- v1.4 — AI Video Script & Storyboard Studio: Auto-generate TikTok/Reels captions, video hooks, and B-roll shot lists.
- v2.0 — Mobile PWA: Progressive Web App with offline support and push notifications for payment due dates.
This project is licensed under the MIT License — see the LICENSE file for full details.
- Pixel Forge AI Hackathon 2026 — Built from scratch in just 5 intense days after discovering the hackathon late.
- AI Pair Programming (Claude & Antigravity) — Architected and developed using agentic AI workflows, demonstrating how a solo designer-developer can ship a full-stack, production-grade OS at 10x speed.
- Groq Cloud — For blazing-fast AI inference speeds powered by LPU technology (
openai/gpt-oss-120b,qwen/qwen3.6-27b). - Lucide Icons — For clean, modern UI iconography.
- Tailwind CSS — For the rapid, utility-first styling system.
- html2canvas & jsPDF — For client-side graphic vector rendering and PDF generation.
Javeria Farhan
Founder, Lead Creator & Software Engineering Student (1st Year, Virtual University of Pakistan)
I am a 21-year-old creative technologist from Pakistan combining Graphic Design, Video Editing, and Software Engineering. Currently a first-year BS Software Engineering student at the Virtual University of Pakistan, I built VASLKAAR to solve the exact operational fragmentation and burnout I faced while balancing freelance client deliverables, design workflows, and university studies.
- 💼 LinkedIn: linkedin.com/in/javeriafarhan
- 🐙 GitHub: @Javeriaf19
- ✉️ Email: javeriafarhan19@gmail.com
- 🌐 Live Application: vaslkaar.vercel.app
- 🇵🇰 Proudly Designed & Built with ❤️ in Pakistan