Work with Lovable in the project chat - Lovable Documentation
Documentation Index Fetch the complete documentation index at: /llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. The project chat is the panel on the left side of the editor where you work with Lovable on your app. You describe what you want in plain language, Lovable builds it, discusses it, or plans it depending on the mode you choose, and each response shows what changed so you can review it, steer it, or undo it.
Behind every message, Lovable’s agent works in a loop: it gathers context from your conversation and project, takes action with tools, and checks the result before moving on. You’ll see that loop reflected in everything below, from activity cards to the questions Lovable asks. You can ask Lovable anything, not just build requests. Ask how your app works, what a term means, or anything else on your mind, and Lovable answers in chat.
You can also ask Lovable to run project actions from the project chat, for example publish my app , deploy this project , ship it , or find me a domain for my bakery . See Publish from the project chat and Set up a custom domain . Every draft has a chat of its own. While you’re in a draft, Lovable applies your requests to that draft instead of to your project, and you can ask it to update or accept the draft from there.
The prompt box Type your message into the text field at the bottom of the chat panel, then press Enter or click the send button. You don’t need any special phrasing. Describe the outcome you want rather than the implementation: Add a sign-up form with email and password fields. See Prompting best practices for more guidance, and the prompt library for ready-made prompts. Around the text field you’ll find: The microphone : Dictate your message instead of typing.
Click it to start recording, or press Option+V (Mac) or Alt+V (Windows/Linux). Lovable transcribes while you speak, removing filler words and cleaning up the text as it goes, so your words are ready as soon as you stop. Click the check to put them in the prompt box for you to review and send, or the X to discard the recording. The mode picker : Switch between Build, Chat, and Plan mode . Option+P (Mac) or Alt+P (Windows/Linux) cycles through the three modes.
The button : Open the Chat actions menu to attach files, add context such as skills, projects, and connectors, and reach common project tools. Modes The mode picker next to the chat input switches how Lovable responds: Build : Lovable makes changes directly in your project. This is the default, and the right choice for most requests, from small tweaks to whole features. Cost is usage-based, and many requests cost less than one credit.
See Build mode . Chat : Lovable discusses the app you have open without changing its code. Use it to ask how something works, explore an idea, or decide what to change. When a change is needed, Lovable shows a Start building card and switches to Build only after you select Build . A Chat mode message is priced on the work it needs, typically a fraction of a credit, and your workspace’s daily chat allowance covers it first.
See Chat mode . Plan : Lovable investigates and plans without touching your code. Use it to think through a bigger feature, debug an issue safely, or compare approaches before building. A Plan mode message costs one credit, plus the cost of any subagent research Lovable runs while planning. See Plan mode . You can switch modes at any time, and the conversation carries across all three. Chat in this picker is Chat mode , a mode of the project chat: the conversation stays in this project, and everyone with access to the project can see it.
Chats is a different place: private conversations with Lovable outside your projects, started from the dashboard or at lovable.dev/chats. Both are chat usage and draw on the same daily chat allowance. For a single message, you can also set a goal : type /goal anywhere in the message, or pick Goal from the Skills list, and Lovable works on that message until the goal is achieved. A goal can take hours and use a large number of credits, and credit check-ins still apply.
Chat actions Click the button next to the chat input to open the Chat actions menu. Related actions are grouped together. Select a group, such as Add context , to see its actions, use the back arrow at the top to return, or type in the search box at the top to find any action by name. Project : History : Open your project’s version history to browse and restore earlier versions. Instructions : Write persistent instructions that Lovable follows in every request, such as your product context or design rules.
See Instructions . Design system : Attach a shared design system to this project. Available on paid plans. See Design systems . Settings : Open your project’s General settings , where you rename the project and manage publishing options. This is one of several ways to open project settings . GitHub : Connect your project to a GitHub repository with two-way sync, so changes flow in both directions. See GitHub . GitLab : Connect your project to a GitLab repository with two-way sync, so changes flow in both directions.
See GitLab . Help & support : On Enterprise plans, you find both items below here. On other plans, Help center is directly in the menu. Help center : Open lovable.dev/support , with the docs, the docs assistant, the Lovable Academy, and the support form. Contact support : On Enterprise plans, open a support request for this project without leaving the editor. Lovable attaches your project, workspace, and account details, and the support team replies by email.
See Contact support from the editor . Add context : Add skills, other projects, connectors, your project’s code, designs, and files to your message. Typing @ in the chat input opens the projects, connectors, code, and designs from this group at your cursor, plus Your files , the files Lovable created for you in Chats . Keep typing to filter the list. On desktop, skills, projects, and connectors show their details in a panel next to the list as you move through it.
Skills : Browse your workspace’s skills and the skills built by Lovable, reusable instruction sets, and run one. Goal is listed here too, under Built by Lovable , and sets the message as a goal . Picking a skill types the / command for you, and typing / in the chat input opens the same list at your cursor. Projects : Point Lovable at another project in your workspace. See Cross-project referencing . Connectors : Mention a connector so Lovable pulls content from it.
The list covers the connectors available to your workspace, with popular ones first. See Connectors . Code : Reference a file from your project’s code, so Lovable works on exactly that file. See Reference code in the project chat . Figma designs : Pick a design you exported with the Lovable Figma plugin. This item appears only after you have exported at least one design. See Figma . Project connectors : Open More → Connectors , which lists the connections your app uses and the MCP servers your project can access.
Select any connection to manage it. See Connectors . Take a screenshot : Open your browser’s screen capture dialog and choose a tab, window, or screen. Lovable attaches the image to your message, so you can show exactly what you mean. Attach files : Add files from your computer to your message, the same action as Attach files directly in the menu. Attach files : Add files from your computer to your message. See Attach files as context .
Attach files as context Attachments show Lovable what you mean. Attach a design mockup to match, a screenshot of a bug to fix, or a document to build from, like a product brief, a spreadsheet of data, or an audio note. Attachments work the same when you create a project from the dashboard: attach files to your very first prompt. To add files, use Attach files
The rest of this page is on the live site.