Module 5: Building Real Things

Guided Build: Your Core Screen

Lesson 5.3 1 activity

Today You Actually Build

This isn't a lesson about building. This IS the building. By the end of this session, you'll have a real, visible main screen for your project running in Replit. Not finished — but real.

This is going to take longer than the earlier lessons, and that's expected. Building a real thing is harder than reading about building. If AI gives you something weird and you have to iterate a few times, that's normal — Lesson 5.2 told you nothing works the first time. Don't panic if it takes a while. Take breaks when you need them.

Before You Start — Checklist

  • Your project plan from Lesson 2.5 is open
  • Your Replit account is set up and you can create a new Repl (you did the test drive in Lesson 3.3)
  • You know which track you're on (1, 2, or 3) and what you're building
  • A parent or older sibling is reachable while you work — even confident kids hit a stuck moment in their first build session

If any of these aren't ready, pause and set them up now. If Replit isn't working, go back to Lesson 3.3 and complete the setup first.

Stuck? Two-tier safety net

If your build session goes sideways, don't keep grinding. The Module 5 Starters page has two safety nets you can fall back on at any time:

  • Starter prompts for each track — fully filled-in prompts that reliably produce a working baseline. Copy your track's prompt into a fresh Repl and you're back on track.
  • Working starter projects — finished, runnable versions of each track's project. The starters page explains two ways to use them: (a) study them as a reference and describe specific features to AI in your own words, or (b) view the source and copy it as a fresh starting point.

Try the starter prompt first; the working code is your last resort if prompts aren't getting you there.

Replit reality check (read this once before you start)

Three things to know about working in Replit so you don't get tripped up:

  • You don't need to "save" or "open in your browser." Replit auto-saves everything as you go, and the live preview pane on the right is your browser preview. Just keep working.
  • Your project lives in a Repl, not in files on your computer. If a prompt or instruction in this course says "open the file" or "save as index.html," what it really means in Replit is "the AI agent should put the code in the file called index.html." AI handles the file management — you just describe what you want.
  • To test on mobile, use the share URL. Click Replit's Share or Webview button to get a URL for the live preview, then open that URL on your phone. (You don't need to "resize your browser to 375px" — opening the URL on an actual phone is better.)

Track 1: Personal Productivity Tool — Build Session 1

Only follow this step if you're on Track 1. If you're on Track 2 or 3, click "Next" to find your track.

What you're building today: The main screen of your productivity tool — the screen users see first and use most.

Step 1: Create a new Repl for your real project. Go to your Replit dashboard and create a new Repl using the HTML/CSS/JS template (same way you did the test drive in Lesson 3.3). Name it something like habit-tracker or whatever fits your project. This is the Repl your final deployed project will live in.

Step 2: Send the build prompt to the AI panel. Below is the template, then a fully filled-in example you can adapt. Paste your version into Replit's AI / Agent panel.

Template (copy this and replace the bold parts with your own info):

I'm building a [habit tracker / study planner / fitness log / budget tracker]. The main screen needs to show: (1) a list of [habits / tasks / exercises / expenses] the user is tracking, (2) a way to mark items as complete or log new entries for today, and (3) a simple visual showing progress (like a streak count or completion percentage). Generate the complete HTML, CSS, and JavaScript for this main screen. Use a clean, modern design with a dark navy background and a bright purple accent color. Make it mobile-friendly. Include sample data so I can see how it looks immediately.

Fully filled-in example (use this exactly as-is if you want — it works):

I'm building a habit tracker. The main screen needs to show: (1) a list of habits the user is tracking, (2) a checkbox next to each habit so the user can mark it done for today, and (3) a progress display at the top that says something like "3 of 5 habits done today." Generate the complete HTML, CSS, and JavaScript for this main screen. Use a clean, modern design with a dark navy background and a bright purple accent color. Make it mobile-friendly. Include 5 sample habits so I can see how it looks immediately: Drink water, Read 10 pages, 20-minute walk, Stretch, Journal.

Expected result: Replit's preview pane (the right side of your screen) updates to show a styled screen with the sample habits visible. It won't save your data between sessions yet — that's Session 2. If the preview looks broken or the page is blank, scroll down to the troubleshooting section.

Step 3: Evaluate what you got. Look at the preview and ask: Does it show the list of items I want to track? Can I see where I'd mark things complete? Is there a progress indicator? Does it look decent (not beautiful yet — just organized and readable)?

Step 4: Direct one revision. Almost nobody gets a perfect result on the first prompt. Pick the single most important thing to fix and tell AI. Examples — pick the one that matches your problem:

Layout is wrong: "Reorganize the layout. Put the progress display at the top, the habit list in the middle, and the add-habit input at the bottom. Keep everything in a single centered column, not too wide."
It's ugly: "Improve the visual design. Add more spacing between the habits, round the corners of each habit card, use a subtle shadow on the main container, and make the habit names bigger and easier to read."
Something is missing: "Add a streak counter that shows next to each habit, displaying how many days in a row I've completed it. Use a small badge style."

Step 5: Make it yours. Replace the sample habits with your actual habits and update the title. Send this prompt:

Update the page title at the top to "My Daily Habits" (or whatever name you want), and replace the sample habits with these 5: [list your 5 real habits, separated by commas].

Track 1 Checkpoint — End of Session 1

You should now have, in Replit:

  • A Repl named for your project, with a working live preview
  • A main screen showing your list of items to track
  • A way to mark items complete (checkboxes or buttons)
  • Some kind of progress indicator (streak, percentage, or count of completed items)
  • Your real project name and your real items — no leftover sample data

Replit auto-saves as you go, so there's nothing to "save" manually. The Repl is your foundation — everything else builds on it. If you don't have all five items above, keep iterating with AI until you do.

Stuck? Don't keep banging on the same prompt. Stop, take a 10-minute break, then either (a) get a parent or sibling to look at it with fresh eyes, or (b) start a new Repl and try a slightly different prompt. Walking away usually solves more than persisting.

Track 2: Creative Portfolio or Community Site — Build Session 1

Only follow this step if you're on Track 2. If you're on a different track, click "Next" to continue.

What you're building today: Your homepage — the first page visitors see, including navigation to other sections.

Step 1: Create a new Repl. From your Replit dashboard, create a new HTML/CSS/JS Repl. Name it for your project — art-portfolio, book-recs, etc.

Step 2: Generate your homepage. Below is the template, then a fully filled-in example. Pick one and paste into Replit's AI / Agent panel.

Template (replace bold parts):

I'm building a [personal art portfolio / book recommendation site / volunteer opportunities guide / study resource hub]. Create a complete homepage in HTML, CSS, and JavaScript. Include: (1) a hero section with a title, subtitle, and brief description of what this site is, (2) a navigation bar with links to [Home, Gallery, About, Contact] (or whatever sections fit my project), (3) a preview section showing 3–4 featured items in a grid with placeholder images and titles, and (4) a footer. Clean, modern design with a dark background and a soft purple accent color. Mobile-friendly.

Fully filled-in example (works as-is for a book recommendation site):

I'm building a book recommendation site for fellow teen readers. Create a complete homepage in HTML, CSS, and JavaScript. Include: (1) a hero section with the title "Reads Worth Your Time" and a subtitle "Honest book recs from one teen to another," (2) a navigation bar with links to Home, Recommendations, Categories, and About, (3) a preview section showing 3 featured book cards in a grid with placeholder images, titles, and one-sentence descriptions, and (4) a footer with my name. Clean, modern design with a dark background and a soft purple accent color. Mobile-friendly.

Expected result: The Replit preview pane shows a homepage with hero, navigation, a 3-card grid, and footer.

Step 3: Evaluate. Does the hero clearly say what the site is? Does the navigation make sense? Does the grid look like a preview of your real content? To check mobile, click Replit's Share button to get a URL, then open it on your phone.

Step 4: Customize with your content.

Update this page: change the title to [Your Site Name], the subtitle to [Your tagline], and replace the 3 preview cards with these: Card 1: [title], [one-sentence description]; Card 2: [title], [description]; Card 3: [title], [description]. Keep placeholder images (colored rectangles are fine).

Step 5: Add the other pages.

Create separate HTML files in this Repl for the other pages in my navigation: [list them — e.g., Recommendations, Categories, About]. Each one should use the same navigation bar and footer as the homepage, with a heading that says "[Page Name] — Coming Soon" as the main content. I'll fill them in next session.

Track 2 Checkpoint — End of Session 1

You should now have, in Replit:

  • A Repl named for your project with a working live preview
  • A homepage with your real site name, tagline, and 3 preview cards
  • A working navigation bar
  • 2–3 additional placeholder pages reachable through navigation
  • A layout that works on mobile (test by opening the Replit share URL on your phone)

Replit auto-saves everything. Don't worry about file management — the AI panel can create and edit files in your Repl when you ask.

Stuck? Take a 10-minute break, then ask a parent or sibling to look at it with fresh eyes, or start a fresh Repl with a slightly different prompt.

Track 3: Data Explorer Dashboard — Build Session 1

Only follow this step if you're on Track 3. If you're on a different track, click "Next" to continue.

What you're building today: Your dashboard layout with at least one working chart and your data connected.

Step 1: Prepare your data. Have your dataset ready — at least 5–10 rows of real or realistic sample data. It can be from a Google Sheet, a CSV, or just typed out. AI will use whatever you paste in.

Step 2: Create a new Repl. From your Replit dashboard, create a new HTML/CSS/JS Repl. Name it for your project — spending-dash, sports-stats, etc.

Step 3: Generate your dashboard. Below is the template, then a fully filled-in example.

Template (replace bold parts):

I'm building a [personal finance tracker / sustainability dashboard / sports stats tool / quiz app]. Create a dashboard page in HTML, CSS, and JavaScript. Use the Chart.js library for charts (load it from a CDN — that's a free way to load JavaScript libraries from the internet, no install needed). Include: (1) a header with the dashboard title, (2) a summary row showing 3–4 key metrics as large numbers with labels (for example: Total, Average, Top Category), (3) a bar chart showing [describe what the chart should display], and (4) a data table below showing the raw rows. Use this sample data: [paste your 5–10 rows of data here] Dark theme, soft green accent color, mobile-friendly.

Fully filled-in example (works as-is for a personal spending tracker):

I'm building a personal spending tracker dashboard. Create a dashboard page in HTML, CSS, and JavaScript. Use the Chart.js library for charts (load it from a CDN — no install needed). Include: (1) a header with the title "My Spending Dashboard," (2) a summary row showing three big numbers: Total Spent This Month, Average Per Day, Top Category, (3) a bar chart showing total spent per category, and (4) a data table below listing every transaction with date, category, amount, and description. Use this sample data: 2025-09-01, Food, 12.50, Lunch with friends 2025-09-02, Transport, 5.00, Bus pass 2025-09-04, Food, 8.75, Coffee 2025-09-05, Entertainment, 15.00, Movie ticket 2025-09-07, Food, 22.00, Groceries 2025-09-09, School, 9.50, Notebook 2025-09-10, Transport, 5.00, Bus pass 2025-09-12, Food, 14.00, Pizza Dark theme, soft green accent color, mobile-friendly.

Expected result: Replit's preview pane shows a dashboard with summary metrics at the top, a working bar chart in the middle, and a data table below.

Step 4: Evaluate. Does the chart actually render (not just an empty box)? Do the summary numbers make sense? Is the data table readable? To test mobile, click Replit's Share button and open the URL on your phone.

Step 5: Add a second chart. A real dashboard tells a story with multiple views.

Add a second chart below the first. Make this one a [pie chart / line chart / doughnut chart] showing [a different angle on the data — e.g., percentage breakdown by category, spending trend over time, top items]. Use the same data. Both charts should have clear titles and labels.

Track 3 Checkpoint — End of Session 1

You should now have, in Replit:

  • A Repl named for your project, with a working live preview
  • 3–4 summary metric cards with real numbers
  • At least 2 charts that actually render with your data (not empty boxes)
  • A data table showing the raw rows
  • Your real data, not just placeholder sample data

Replit auto-saves. In Session 2, you'll add interactivity (filters, user input) and persistent storage.

Stuck? Take a 10-minute break, then ask a parent or sibling to look at it with fresh eyes, or start a fresh Repl with a slightly different prompt.

When Things Go Wrong (And They Will)

Three common problems and the prompts that fix them. In Replit you don't need to "paste the code" — the AI panel can already see your project. Just describe the problem.

The preview is blank or shows an error. Most likely cause: a typo in the code AI generated.

The preview is showing [blank / an error message that says: paste the message] instead of my project. Check the code for errors and fix them. Tell me in plain English what was wrong.

It works but looks completely different from what I asked for. Your prompt wasn't specific enough. Don't start over — describe the gap.

This isn't what I wanted. I expected [describe what you expected], but instead I got [describe what AI built]. Revise the page to match what I expected. Keep anything that's already working.

It partially works but one section is broken. Isolate the problem area.

Everything works except [the progress counter / the navigation bar / the chart / etc.]. Right now it shows [what's happening], but it should [what you want]. Fix only that part — don't change anything else.

KEY CONCEPTS

KEY CONCEPTS — LESSON 5.3

1. Your first AI-generated code is a starting point, not a finished product. Evaluate it, then iterate.

2. Be specific in your prompts: describe layout, features, colors, and include sample data so you can see results immediately.

3. Fix one thing per prompt. Don't try to change five things at once — you won't be able to tell what worked.

4. Replace sample data with your real project content before ending the session.

5. Replit auto-saves your Repl as you work — there's no "save the file" step. Just keep working until your checkpoint is met.

Level Up: Coming Next

Lesson 5.4 — Guided Build: Functionality & Data. Transform your static screen into a fully functional project with user input and data storage.

Continue to Lesson 5.4 →