BeginnerLesson 5 of 305 min read

Proposals and Quotes

Write a short proposal with six parts, add up a quote, give it a valid-until date and a clear next step, and check it all with a small program on made-up numbers.

In this lesson you will

  • Name the six parts of a proposal
  • Add up a quote
  • Write a specific scope
  • Send a proposal well and handle a no

About 24 minutes

The cafe owner says yes to a proposal

Dev spoke to the cafe owner and the owner said, ‘Send me a proposal.’ A proposal is a short document that says what you will do, how, by when and for how much. A quote is the price part of it. Good ones are short and clear. They show the client that you understood the problem, and they protect you by writing the details down before work starts.

Six parts of a good proposal

  • The problem. Say in a sentence what the client needs, in their words.
  • The scope. What you will do, and what you will not do.
  • The deliverables. The actual things the client will receive.
  • The timeline. When you will start and finish, and what you need from them.
  • The price. A clear total, with the breakdown.
  • The next step. What the client should do to say yes.

The next step is the part people forget. If a proposal ends with no instruction, a busy client may just leave it in their inbox.

Check one in code

The program below holds a made-up proposal for Dev’s cafe job. It checks that all six parts are present, counts the words and adds up a quote from its lines. It also works out how long the quote is valid, using a real calendar.

from datetime import date, timedelta

sections = ["problem", "scope", "deliverables", "timeline", "price", "next step"]
proposal = {
    "problem": "Your website has typos that put customers off.",
    "scope": "Proofreading of 8 pages. No new writing.",
    "deliverables": "Marked-up pages and a one-page style sheet.",
    "timeline": "Three working days from approval.",
    "price": "169 in total, see the quote.",
}
missing = [s for s in sections if s not in proposal]
print("sections present:", len(sections) - len(missing), "of", len(sections))
print("missing:", missing)
print("words in proposal:", sum(len(t.split()) for t in proposal.values()))

lines = [("Proofread pages", 8, 18.00), ("Style sheet", 1, 25.00)]
total = 0
for name, qty, unit in lines:
    amount = qty * unit
    total += amount
    print(f"{name}: {qty} x {unit:.2f} = {amount:.2f}")
print("quote total:", f"{total:.2f}")
print("extra round (optional):", f"{2 * 18.00:.2f}")

sent = date(2026, 11, 2)
valid = sent + timedelta(days=14)
print("sent:", sent.strftime("%a %d %b"))
print("valid until:", valid.strftime("%a %d %b"))
sections present: 5 of 6
missing: ['next step']
words in proposal: 33
Proofread pages: 8 x 18.00 = 144.00
Style sheet: 1 x 25.00 = 25.00
quote total: 169.00
extra round (optional): 36.00
sent: Mon 02 Nov
valid until: Mon 16 Nov

Only 5 of 6 sections are present. The missing one is ‘next step’, exactly the one people forget. The whole proposal runs 33 words, which is a good length: short enough to read in a minute. The quote adds up as 144.00 for eight pages and 25.00 for a style sheet, giving a total of 169.00. An optional extra round of changes is priced separately at 36.00, so the client knows what more work would cost before it happens. The quote was sent on Mon 02 Nov and is valid until Mon 16 Nov. A deadline gives the client a reason to decide, and it protects you if your costs or availability change.

Write the scope carefully

The scope is where most trouble starts later. Be specific: ‘proofreading of 8 pages’ is clear, and ‘help with the website’ is not. Say what is not included, such as new writing, and how many rounds of changes are covered. If the client wants more, it becomes a new quote. This is not unfriendly. It is the way both sides know what they agreed.

Send it well

  1. Send it soon after the conversation, while the client is still interested.
  2. Put the key facts in the email body, so nobody has to open a file to learn the price.
  3. Attach the proposal as a simple document or PDF.
  4. Say you are happy to answer questions, and when you will check back.
  5. Follow up once, politely, after a few days if you hear nothing.

When the answer is no

Some proposals are turned down. That is part of the work. If a client says the price is too high, ask whether a smaller scope would suit. If they go elsewhere, thank them and leave the door open. Keep a note of why, as patterns teach you something. A client who says no today may say yes next year.

Common mistake: writing about yourself

Sending a proposal that is really a long essay about yourself. Clients care about their problem first. Spend one sentence on yourself and the rest on what you will do for them.

Sample data and not legal advice

The proposal text, prices and dates are made-up examples in sample money. A quote is a business document and may become part of a contract, so keep it accurate. This lesson is an outline and not legal advice.

Write a proposal for a job you could do, using the six parts. Add up a quote from its lines, add a valid-until date and give it a clear next step.

Practice for this lesson

Check what you learned

Five quick questions. Pick an answer and you will see straight away whether it is right and why.

What is the next step part of a proposal for?

  1. Describing yourself
  2. Listing tools
  3. Telling the client how to say yes
  4. Giving a discount

Without it, a busy client may do nothing.

Which section was missing in the example?

  1. Next step
  2. Price
  3. Scope
  4. Timeline

Only the next step was left out.

Why give the quote a valid-until date?

  1. It lowers the price
  2. It gives a reason to decide and protects you from changes
  3. It is a law
  4. It looks long

Deadlines help decisions and protect you if costs change.

Why price an extra round separately?

  1. To hide costs
  2. To save paper
  3. To shorten the job
  4. The client sees what more work costs before it happens

Clear extras prevent surprise bills and arguments.

How should the scope be written?

  1. Vaguely
  2. Specifically, with what is and is not included
  3. In the client’s language only
  4. As a slogan

A specific scope prevents later disputes.

Summary

  • A proposal states the problem, scope, deliverables, timeline, price and next step.
  • Write the scope specifically, including what is not included.
  • Price extras separately and give the quote an expiry date.
  • Follow up once and take a no calmly.

Next lesson

Lesson 6 gives an outline of contracts and scope.

Questions

How long should a proposal be?

Short enough to read in a minute or two for a small job. Longer jobs may need more detail, but keep it clear.

Do I need a proposal for every job?

For small jobs a clear email with scope, price and timeline can do the same work. The point is to write the details down.

Are these prices real?

No. They are made-up sample amounts. Use your own floor and estimates.

Progress is saved in this browser.