Documentation

Everything you need to know about using ProposalForge.

Getting Started#

Get your first AI-powered proposal package in under 3 minutes.

  1. 1

    Sign in with Google

    Go to app.proposalforge.dev and sign in. You'll receive free credits to get started.

  2. 2

    Upload your resume & paste the job description

    Upload your PDF resume and paste the full job description from the freelance platform. ProposalForge automatically selects the best knowledge pack for the project type.

  3. 3

    Run the pipeline & share your proposal

    Click "Generate Proposal". In ~3 minutes you'll have a live MVP demo URL, tailored resume PDF, and cover letter ready to share with your client.

How It Works#

ProposalForge runs a 5-phase pipeline plus parallel resume and cover letter generation, targeting a 3-minute total runtime.

  1. 1

    Plan

    Analyzes the job description, infers the required app type, and selects the matching knowledge pack. Produces a structured build plan.

  2. 2

    Scaffold

    Generates the project file structure and starter code using the selected pack template. Creates all necessary configuration files.

  3. 3

    Code

    An LLM coding agent fills in the application logic, UI components, and API endpoints based on the build plan and your JD context.

  4. 4

    Validate

    Builds and lints the code inside a Cloud Run container. If errors are found, a Gemini fix-loop runs up to 3 iterations to resolve them.

  5. 5

    Deploy

    Deploys the validated app as a live Cloud Run service. The demo URL is active for 7 days.

Resume tailoring and cover letter writing run in parallel during the pipeline, so both artifacts are ready when deployment completes.

Knowledge Packs#

Knowledge packs are specialized templates that define the architecture, code patterns, and design system for each app type. ProposalForge automatically detects the right pack from your job description — no manual selection required.

Each pack includes a Dockerfile, starter code, UI theme, and Tailwind configuration tuned for that domain.

bookingecommercecrmkanbansaas-pricingsaas-onboardingblog-cmsdata-vizdocs-sitesocial-feedcalendarai-analyticsform-builderhr-portalinventoryreal-estaterestaurant-posworkflowapi-onlyfullstack-fastapifullstack-express

Credits#

Each full pipeline run costs 1 credit. Credits never expire and there's no subscription required.

PackCreditsPriceBest for
Starter12$9First proposals, testing the platform
Pro30$19Active freelancers, multiple bids/week
Scale65$39Agencies, high-volume bidding

1 credit = 1 full pipeline run (MVP demo + resume + cover letter). Purchase more credits from the billing page.

What You Get#

Each pipeline run produces a complete proposal package:

  • Live Demo URL

    A working Cloud Run app deployed at a public URL. Active for 7 days — share it directly with your client in the proposal.

  • Resume PDF

    Your uploaded resume tailored to the job description using keyword matching and relevance scoring. Downloadable as a formatted PDF.

  • Cover Letter

    A personalized cover letter that references the client's specific requirements, your experience, and the live demo you've built for them.

  • Source ZIP

    The complete source code of the generated demo app, packaged as a downloadable ZIP. Useful for handing off or customizing after winning the contract.

FAQ#

Can I cancel a generation mid-run?

Currently, there is no cancel button during pipeline execution. Once started, the pipeline runs to completion. Credits are only deducted on successful generation — if the pipeline fails completely, your credit is refunded.

What happens if the build fails?

ProposalForge runs an automatic validation loop that attempts to fix build errors using Gemini (up to 3 iterations). If the build still fails after 3 attempts, the pipeline exits and your credit is refunded.

How do unused credits work?

Credits never expire. Once purchased, they remain in your account until used. There's no monthly reset or subscription requirement.

What tech stack is used for the demo?

Demos are built with React + Tailwind CSS (frontend), with either Node.js/Express or Python/FastAPI backends depending on the knowledge pack selected. All demos run in Docker containers on Cloud Run.

Can I customize the demo after generation?

Yes. Download the source ZIP from the artifacts panel and modify it freely. You can re-deploy to your own Cloud Run project or any other hosting provider.

Is my resume stored securely?

Resume data is stored in Google Cloud Storage with access restricted to your authenticated session. We do not use your resume data to train models or share it with third parties. You can delete your account and all associated data at any time from the profile settings.