
Before you begin
You’ll need:- A free Replit account (sign up at replit.com)
- A modern web browser (Chrome, Firefox, Safari, or Edge)
This tutorial uses Agent, which is included in the free Starter plan with daily credits. No credit card required.
Build your piano
Start with an idea
Agent is Replit’s AI that builds apps from natural language. You describe what you want, and Agent writes the code, designs the interface, and creates a working app.To communicate with Agent, you write a prompt - a text instruction describing what you want to build. Be specific about what you want to build, how you want it to look, and how it will work.
Build a realistic 16-key piano with proper white and black key layout that looks exactly like a real piano. Each key should press down with realistic depth animation when clicked and play the correct note.
What to buildThe main thing you want
How it looksVisual details and design
How it worksInteractions and behavior
Agent builds your piano
Agent will set up your app and start building. You’ll see real-time updates in the Progress tab as Agent creates your piano.
When Agent finishes, it will show you what it built. The process takes about five minutes.

Play your piano
Once Agent completes, navigate to the Preview tab to see and interact with your piano.Click the keys to hear them play and see the realistic press-down animation.Click the keys labeled with these note names to play the tune.
Your piano design might look slightly different since Agent can generate varied results from the same prompt.
Try playing a tune
Use the note names shown on your piano to play “Mary Had a Little Lamb”:Stretch goal: Add recording
Want to take it further? Ask Agent to add a record button so you can capture your melody and play it back. Try prompting: “Add a record button that lets me record what I play and a play button to hear it back.”Continue your journey
Now that you’ve built your first app, here’s what to try next:- Build something new: Try creating a game, drawing app, or anything you can imagine with Agent
- Share with friends: Publish your piano so others can play it. Learn how in Replit Deployments
- Keep learning: Learn about App Mode vs Design Mode to understand when to use each