> Source URL: /unit-3/project-paths/lucas-w/lucas-w-2026-04-14.guide
# 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:

   ```text
   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:

   ```text
   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:

   ```text
   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:

- [x] Completed `project.spec.md`
- [x] Project initialized with `uv` and dependencies installed
- [ ] A basic scaffolding that runs (fix app.py, move templates)
- [ ] One tiny working feature (lead capture form that saves data)
- [ ] Journal entry updated in `project.journal.md`
- [ ] Everything committed and pushed to GitHub

## Helpful Resources

- [Flask Setup Guide](../../resources/flask-setup.guide.md) -- reference for project structure and templates
- [Checkpoint 1 Instructions](../../projects/final-project-checkpoint-1.project.md) -- the full checkpoint requirements


---

## Backlinks

The following sources link to this document:

- [April 14 -- Checkpoint 1 prep](/unit-3/project-paths/lucas-w/lucas-w.path.llm.md)
