Want to look under the hood? The Files tab, next to Preview, shows all of your project’s code. You can browse folders, search for a file, and open it to see what’s inside.
Your changes are saved to your project, just like the agent’s. While the agent is working, you’ll see AI is editing this file on files it’s changing, and you can’t save until it finishes.Some files, like .env files, can’t be edited here. To change your API keys, use Environment Variables instead.
Using BuildAvelo on your phone? Open the Files tab at the top of your project. Tap a file to open it, then tap Edit to make changes and Save when you’re done.
Type @ in the chat box to point the agent to a specific file or folder. Start typing its name, pick it from the list, and it’s added to your message. This helps the agent find exactly what you’re talking about.The agent uses the same references in its replies. Click one to open that file in the Files tab.
You don’t need to know where things live in your code to use BuildAvelo — describing what you see on the screen works great. But if you do know the file, referencing it with @ saves the agent a few steps.
⌘I
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"BuildAvelo Docs","colors":{"primary":"#737373","light":"#A3A3A3","dark":"#404040"},"logo":{"light":"/_assets/mintcdn.com/buildaveloinc/rT--gtZCgg61ozhU/logo/buildavelo-logo_light.png?fit=max&auto=format&n=rT--gtZCgg61ozhU&q=85&s=da424bbf4b10d0109ec2004d2c23d46a","dark":"/_assets/mintcdn.com/buildaveloinc/rT--gtZCgg61ozhU/logo/buildavelo-logo_dark.png?fit=max&auto=format&n=rT--gtZCgg61ozhU&q=85&s=877205a080887974da24a0e16527ba2b"},"favicon":{"light":"/_assets/mintcdn.com/buildaveloinc/j2uhLFRPbCM-rhcH/favicon-light.png?fit=max&auto=format&n=j2uhLFRPbCM-rhcH&q=85&s=20a91691824f0cd71b0574a5449e6e49","dark":"/_assets/mintcdn.com/buildaveloinc/j2uhLFRPbCM-rhcH/favicon-dark.png?fit=max&auto=format&n=j2uhLFRPbCM-rhcH&q=85&s=d7d2ba491f7b0e5131736bbfcca5de9c"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://app.buildavelo.com/login"}},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"background":{"color":{"light":"#fbfbfb","dark":"#0e0e10"}},"navigation":{"global":{"anchors":[{"anchor":"buildavelo.com","icon":"arrow-up-right","href":"https://buildavelo.com/"},{"anchor":"kodolitsch@buildavelo.com","icon":"envelope","href":"mailto:kodolitsch@buildavelo.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"buildaveloinc","hasAudioNarration":false,"actualSubdomain":"buildaveloinc","customDomains":["docs.buildavelo.com"],"gitSource":{"type":"github","owner":"buildavelo","repo":"docs.buildavelo.com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac2c7ab292f7a78aa46bdd9","collectionId":"317f1ab8-3e36-472a-ba1a-ba2a8b76c8b5","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac2c7ab292f7a78aa46bdd9"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ac2c7ab292f7a78aa46bdd9","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Features","count":12},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Prompting","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"features/files","slug":"/features/files","pageMetadata":{"title":"Files","description":"Browse and edit your project's code, and point the agent to specific files.","href":"/features/files"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Browse and edit your project’s code, and point the agent to specific files.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Note,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`the-files-tab`,children:`The Files Tab`}),`\n`,_jsxs(_components.p,{children:[`Want to look under the hood? The `,_jsx(_components.strong,{children:`Files`}),` tab, next to `,_jsx(_components.strong,{children:`Preview`}),`, shows all of your project’s code. You can browse folders, search for a file, and open it to see what’s inside.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`The Files tab requires a Core plan or above.`})}),`\n`,_jsx(Heading,{level:`3`,id:`editing-files`,children:`Editing Files`}),`\n`,_jsx(_components.p,{children:`You can also edit files yourself:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Open the file you want to change.`}),`\n`,_jsx(_components.li,{children:`Make your changes.`}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`, or press `,_jsx(_components.strong,{children:`⌘ S`}),` (`,_jsx(_components.strong,{children:`Ctrl S`}),` on Windows).`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Your changes are saved to your project, just like the agent’s. While the agent is working, you’ll see `,_jsx(_components.strong,{children:`AI is editing this file`}),` on files it’s changing, and you can’t save until it finishes.`]}),`\n`,_jsxs(_components.p,{children:[`Some files, like `,_jsx(_components.code,{children:`.env`}),` files, can’t be edited here. To change your API keys, use `,_jsx(_components.a,{href:`/features/environment-variables`,children:`Environment Variables`}),` instead.`]}),`\n`,_jsx(Heading,{level:`3`,id:`on-your-phone`,children:`On Your Phone`}),`\n`,_jsxs(_components.p,{children:[`Using BuildAvelo on your phone? Open the `,_jsx(_components.strong,{children:`Files`}),` tab at the top of your project. Tap a file to open it, then tap `,_jsx(_components.strong,{children:`Edit`}),` to make changes and `,_jsx(_components.strong,{children:`Save`}),` when you’re done.`]}),`\n`,_jsx(Heading,{level:`2`,id:`referencing-files-in-the-chat`,children:`Referencing Files in the Chat`}),`\n`,_jsxs(_components.p,{children:[`Type `,_jsx(_components.strong,{children:`@`}),` in the chat box to point the agent to a specific file or folder. Start typing its name, pick it from the list, and it’s added to your message. This helps the agent find exactly what you’re talking about.`]}),`\n`,_jsx(_components.p,{children:`The agent uses the same references in its replies. Click one to open that file in the Files tab.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`You don’t need to know where things live in your code to use BuildAvelo — describing what you see on the screen works great. But if you do know the file, referencing it with `,_jsx(_components.strong,{children:`@`}),` saves the agent a few steps.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Files","description":"Browse and edit your project's code, and point the agent to specific files.","href":"/features/files"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The Files Tab","slug":"the-files-tab","depth":2,"children":[{"title":"Editing Files","slug":"editing-files","depth":3,"children":[]},{"title":"On Your Phone","slug":"on-your-phone","depth":3,"children":[]}]},{"title":"Referencing Files in the Chat","slug":"referencing-files-in-the-chat","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"buildaveloinc","siteName":"BuildAvelo Docs","title":"Files - BuildAvelo Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T21:07:21.429Z","originalFileLocation":"features/files.mdx"},"headHtml":"","siteName":"BuildAvelo Docs","nav":{"global":{"anchors":[{"anchor":"buildavelo.com","icon":"arrow-up-right","href":"https://buildavelo.com/"},{"anchor":"kodolitsch@buildavelo.com","icon":"envelope","href":"mailto:kodolitsch@buildavelo.com"}]},"groups":[{"group":"Getting Started","pages":[{"title":"Welcome to BuildAvelo","href":"/index"},{"title":"Quick Start","href":"/getting-started"},{"title":"Saving Credits","href":"/features/saving-credits"},{"title":"Free Credits","href":"/features/free-credits"},{"title":"Tech Stack","href":"/features/tech-stack"},{"title":"Getting Help","href":"/features/support"}]},{"group":"Prompting","pages":[{"title":"Writing Good Prompts","href":"/features/writing-good-prompts"},{"title":"Plan Mode","href":"/features/plan-mode"},{"title":"Debug Mode","href":"/features/debug-mode"}]},{"group":"Features","pages":[{"title":"BuildAvelo Cloud","href":"/buildavelo-cloud"},{"title":"Environment Variables","href":"/features/environment-variables"},{"title":"Live Preview","description":"Preview your app in real time as you build it with BuildAvelo.","href":"/features/live-preview"},{"title":"Files","href":"/features/files"},{"title":"Deployment","description":"Deploy your BuildAvelo app to the web, Android, and iOS.","href":"/features/deployment"},{"title":"Custom Domain","href":"/features/custom-domain"},{"title":"BuildAvelo Watch","href":"/features/watch"},{"title":"Checkpoints","href":"/features/checkpoints"},{"title":"GitHub Integration","href":"/features/github-integration"},{"title":"Import from GitHub","href":"/features/import-from-github"},{"title":"Lovable to Native App","href":"/features/lovable"},{"title":"Base44 to Native App","href":"/features/base44"}]}]},"title":"Files - BuildAvelo Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}