> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# How to build your first project
> Your first website or app, built today
You describe what you want in plain language, and Macaly builds it for you. Think of it like texting a very skilled developer who works instantly.
## Before you start
You don't need a detailed plan. But if you're not sure where to begin, these are great first projects:
Simple, focused, fast to build. Perfect for testing an idea.
A few pages about you, your work, and how to get in touch.
Home, about, services, contact. A solid starting structure.
A simple tool for your team to track tasks or display data.
**What to have ready:**
* A short description of what your site is about (one sentence is enough)
* Your logo, if you have one
* Brand colors, or a reference website you like the look of
Don't overthink it. Everything can be changed later, so your first version doesn't need to be perfect.
## Build your first project
Sign in at [macaly.com](https://www.macaly.com/). The prompt input is front and center on the home screen.
Tell Macaly what you have in mind, the same way you'd explain it to a friend. Any language works.
If you have materials ready (a logo, brand guidelines, a PDF with content), attach them straight away. The more context Macaly has from the start, the better the first result.
Macaly starts building right away. It may ask a question or two along the way if something needs clarifying.
The first version can take up to a few minutes. You'll see updates in the chat as the agent works.
Check the preview on the right. Look at the layout, text, images, and overall feel. Use the device toggle above the preview to instantly see how your site looks on mobile, tablet, and desktop.
It won't be perfect on the first try, and that's completely normal. Keep refining by sending follow-up messages in the chat, or use the toolbar over your preview to make precise changes directly on the page.
## How to talk to Macaly
Talk to Macaly like a friend. No commands, no technical terms. Just say what you want.
Start with something concrete:
```
I want to create a website for my café called Dusk. It's a small,
cozy place in Prague. Great coffee, homemade pastries, live jazz
on weekends. Warm colors, lots of food photography.
```
Then keep the conversation going. Each message builds on what was already built:
```
I found a site I really like the vibe of: https://example.com
Can we do something similar for the homepage?
```
```
Swap the Google Maps reviews for a photo gallery.
```
```
Can you add a menu section? I have our full menu as a PDF,
I'll upload it. Can you pull the items and prices from it?
```
Macaly keeps the full context of your project throughout the conversation, so it never loses track of what you've already built.
### A few tips
* **Better results start with context.** Share a reference site, upload your logo, or explain who the site is for. The more Macaly knows, the better the output.
* **Describe the result, not the steps.** Focus on what you want it to look or feel like. Macaly figures out the how.
* **Send one request at a time.** Focused messages get better results than long lists. If you have several changes in mind, send them one by one and Macaly will work through them in order.
* **Ask before you build.** Not sure if something is possible? Just ask. Macaly can walk you through the options before any work begins.
* **Say what's off, not just that it's wrong.** "The font feels too formal" gives Macaly something concrete to work with. "Try again" doesn't.
## When something goes wrong
Something not looking right? That's completely normal, especially early on. Here's what to do:
* **Ask the agent to undo it.** Describe what changed and say you want it reverted. Works best when just one thing went wrong.
* **Restore a previous version.** If several things went sideways at once, restoring is faster than undoing step by step. Each agent response has a "Restore this version" button. Click it to roll back to that point.
* **Edit a previous prompt.** Go back to any earlier message and edit it. Macaly rewinds the project to that moment and rebuilds it from your updated prompt.
* **Start from a safe copy.** Before making big changes, click "Duplicate" under any message. That way you always have a fallback to return to.