Lucas's Project Guide

Project: Lead Generation Landing Page Category: Web App (Flask) Last updated: April 14

Note: This guide is created based on the latest state of your project repository + any notes from our discussion. It may not always reflect the most up-to-date information.

Where You Are

You're the furthest along in the class right now. You have:

  • A filled-out spec with a real-world use case (lead generation for roofing sales)
  • pyproject.toml with Flask installed
  • An app.py with a Flask route
  • A home.html template
  • A solid journal entry

That said, your app isn't quite working yet. Based on your code comments, you ran into an issue where app.py was empty and your Flask code was in main.py. It looks like you've since added code to app.py, but there's a lot of debug commentary mixed in with the code that should be cleaned up. Also, logic.py is empty and home.html is just a placeholder.

The goal for today: get your Flask app running cleanly and add the lead capture form.

Next Steps (Before Tomorrow 3pm)

  1. Clean up app.py. Remove the debug comments and make sure it runs:

    Read my app.py. It has a lot of debug comments mixed in from
troubleshooting. Clean it up so it's just the working Flask code.
Make sure I can run it with: uv run flask run

  2. Add the lead capture form. This is your first working slice -- a form that collects name, phone, email, and address:

    Read my project.spec.md. Help me build a lead capture form on my
home page. The form should collect: name, phone number, email,
and address. When submitted, save the data (to a file or SQLite
for now) and show a confirmation page. Keep it simple but make
it look clean.

  3. Fix your file structure. Your home.html should be in a templates/ folder for Flask to find it. Move it there:

    My home.html is in the project root but Flask expects templates
in a templates/ folder. Help me reorganize: move home.html to
templates/home.html and make sure app.py uses render_template
correctly.

  4. Update your journal. Add what you fix and build today.

  5. Commit and push.

Checkpoint 1 Readiness

By Thursday April 16th at 3pm, you need:

Helpful Resources