The fastest path to a working Frontic project with real data flowing through it. By the end of this page you’ll have a project, storages, and data you can build against.
1
Create an account and a project
Head to the admin app and sign up. Once you’re in, go to Settings → Projects and click Add Project. Give it a name and set it Active.The admin app then walks you through three setup steps: add at least one Locale, one Region that offers it, and one Domain. Frontic needs all three before it can serve data, and the project stays in these steps until they are done. If you’re unsure, pick your primary market and default language. You can add more later. See Project Settings and Domains for the full reference.
2
Get data in
Pick the route that matches where you are.
Connect your stack
Analyze Storefront
If you want to wire things up yourself, connect a source through a Connector. Shopify, Shopware, commercetools, Akeneo, Storyblok, Contentful, and more are supported - or bring your own via Custom Integration.
Pick a pre-built connector or wire up your own through the Custom API
Once the connector is running, raw records flow into a Feed. From there, set up a Data Sync to map feed data into your Data Storages. The Value Composer handles the per-field shaping - defining how each target field gets its value from the source.
Buddy can help here. Describe the source shape and the target shape, and Buddy will propose a sync configuration you can review and approve.
Already have a live shop? Paste its URL into the Shop Importer and let Frontic do the rest.Frontic profiles the site automatically - it detects the platform, locales, currencies, navigation structure, categories, and product model. Once the profile is ready, review it and adjust anything that doesn’t look right.When you confirm, Frontic provisions the entire project for you: Data Storages, Data Syncs, field mappings, and the initial data import. No manual wiring needed.
The shop importer is available for Shopify and Shopware stores today, with more platforms coming.
3
Set up your Context Base
The Context Base is the shared knowledge layer that every agent reads - whether you build in Studio or in your editor with our CLI and MCP. It holds your design system, coding standards, tone of voice, and business context so agents don’t start from zero.Open Studio from the sidebar. On a project that hasn’t run it yet, Frontic steers you into Context Setup first (it’s rolling out gradually): it reads your storefront, asks a short interview about what it couldn’t work out - what you sell, your brand, your design preferences, your coding conventions - and generates the full context for you. Skip for now is always there if you’d rather come back to it.
You can rerun the setup any time (/init-context) to update your context
as the project evolves. See Context Base for more.
4
You're ready to build
Your project has data in it, Studio knows your conventions, and the backend is live. Pick a route and start shipping.
Your first feature
A walkthrough that shows you Studio and your editor side by side.
Build in Studio
Open a Studio job and start creating the experience.
The importer currently supports Shopify and Shopware. If your shop runs on a different platform, use the Connect your stack route and pick the matching connector - or a custom integration if there’s no pre-built one.
My feed is empty after connecting a source
Connectors poll or sync on their own schedule. Give it a minute, then check the feed records view. If nothing shows up, check the connector’s status and credentials in the Integrations section.
My Data Storage fields don't match my feed shape
That’s expected. The Data Sync + Value Composer step is where you map and transform. Start with a direct mapping for the fields that match 1:1 and use composer operations for the rest.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Frontic Docs","description":"Frontic - an AI platform for shipping shopping experiences in a fraction of the time, with double the fun.","colors":{"primary":"#a855f7","light":"#c084fc","dark":"#8b5cf6"},"logo":{"light":"https://mintcdn.com/frontic/QEEg-J3fIyHJ_Wyh/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=QEEg-J3fIyHJ_Wyh\u0026q=85\u0026s=36391b9f3546193a73f97d7b6ee40463","dark":"https://mintcdn.com/frontic/QEEg-J3fIyHJ_Wyh/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=QEEg-J3fIyHJ_Wyh\u0026q=85\u0026s=704f0d073af32f152eab7ab9e4229a9b"},"favicon":"https://mintcdn.com/frontic/QEEg-J3fIyHJ_Wyh/logo/light.svg?fit=max\u0026auto=format\u0026n=QEEg-J3fIyHJ_Wyh\u0026q=85\u0026s=add2ba40542c32e89fccea55bbd2afbd","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"Authorization"},"server":"https://ingest-{integration-id}.frontic.com"}},"appearance":{"default":"dark","strict":false},"navbar":{"links":[{"href":"mailto:support@frontic.com","label":"Support"},{"href":"https://www.frontic.com","label":"Website"}],"primary":{"type":"button","label":"Log In","href":"https://app.frontic.com"}},"footer":{"socials":{"github":"https://github.com/frontic","linkedin":"https://www.linkedin.com/company/102853312"},"links":[{"header":"Resources","items":[{"label":"Changelog","href":"https://frontic.com/changelog"},{"label":"Status","href":"https://status.frontic.com"}]},{"header":"Company","items":[{"label":"Website","href":"https://www.frontic.com"},{"label":"Support","href":"mailto:support@frontic.com"}]}]},"search":{"prompt":"Search Frontic docs..."},"styling":{"codeblocks":{"theme":"css-variables"},"latex":false},"integrations":{"posthog":{"apiKey":"phc_4DuVaMwZYdzCq7HW2hyorMIALyLvxWvC2STOIk8z1lr","apiHost":"https://eu.posthog.com"}},"contextual":{"options":["copy","chatgpt","claude","mcp","cursor"],"display":"header"},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"frontic","hasAudioNarration":false,"actualSubdomain":"frontic","customDomains":["docs.frontic.com"],"gitSource":{"type":"github","owner":"frontic","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae7c42deeb506b36f78cabb","collectionId":"1bbaa1b1-930b-4c2d-b260-45171d33ed14","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae7c42deeb506b36f78cabb"},"feedback":{"agentFeedback":true},"entitlements":{},"buildId":"6ae7c42deeb506b36f78cabb","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Documentation","count":52},{"language":"default","tag":"Connectors","count":24},{"language":"default","tag":"Reference","count":24},{"language":"default","tag":"Fetch API","count":9},{"language":"default","tag":"Build in Frontic","count":8},{"language":"default","tag":"Context Base","count":7},{"language":"default","tag":"Essentials","count":7},{"language":"default","tag":"Project Settings","count":7},{"language":"default","tag":"Ingest API","count":6},{"language":"default","tag":"API Builder","count":5}]},"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":"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":"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":"full-page-search","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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@keyframes glow-float-1{0%,to{transform:translate(0,0) scale(1)}50%{transform:translate(30px,20px) scale(1.1)}}@keyframes glow-float-2{0%,to{transform:translate(0,0) scale(1)}50%{transform:translate(-20px,30px) scale(1.15)}}@keyframes glow-float-3{0%,to{transform:translate(0,0) scale(1)}50%{transform:translate(20px,-20px) scale(1.05)}}:root{--frontic-purple:#a042ff;--frontic-purple-secondary:#784dcb;--frontic-purple-light:#c084fc;--frontic-violet:#8b5cf6;--frontic-dark-bg:#131117}html.dark{background:#0a0a0f}html.dark body{background:0 0}html.dark body::after,html.dark body::before,html.dark::before{content:\"\";position:fixed;border-radius:50%;filter:blur(112px);opacity:.5;pointer-events:none;z-index:-1}html.dark body::before{top:-10%;left:10%;width:600px;height:600px;background:radial-gradient(circle,rgba(160,66,255,.4) 0,transparent 70%);animation:glow-float-1 8s ease-in-out infinite}html.dark body::after{top:30%;right:5%;width:500px;height:500px;background:radial-gradient(circle,rgba(120,77,203,.35) 0,transparent 70%);animation:glow-float-2 10s ease-in-out infinite}html.dark::before{bottom:10%;left:30%;width:400px;height:400px;background:radial-gradient(circle,rgba(168,85,247,.25) 0,transparent 70%);animation:glow-float-3 9s ease-in-out infinite}html:not(.dark){background:#fafafa;--mint-background:#faf5ff;--mint-foreground:#111827;--mint-color-text:#111827;--mint-color-background:#faf5ff;--mint-token-constant:#7c3aed;--mint-token-string:#059669;--mint-token-comment:#9ca3af;--mint-token-keyword:#a855f7;--mint-token-parameter:#6366f1;--mint-token-function:#8b5cf6;--mint-token-string-expression:#059669;--mint-token-punctuation:#6b7280;--mint-token-link:#a855f7}html:not(.dark) body{background:0 0}html:not(.dark) body::after,html:not(.dark) body::before{content:\"\";position:fixed;border-radius:50%;filter:blur(100px);pointer-events:none;z-index:-1}html:not(.dark) body::before{top:-10%;left:10%;width:600px;height:600px;background:radial-gradient(circle,rgba(160,66,255,.15) 0,transparent 70%);animation:glow-float-1 8s ease-in-out infinite}html:not(.dark) body::after{top:40%;right:5%;width:500px;height:500px;background:radial-gradient(circle,rgba(120,77,203,.12) 0,transparent 70%);animation:glow-float-2 10s ease-in-out infinite}.prose,[class*=content],body,main,nav:not([class*=top]){background:0 0!important}html.dark #sidebar{background:linear-gradient(180deg,rgba(160,66,255,.03) 0,transparent 100%)!important}#sidebar,#sidebar-content{box-shadow:none!important}html.dark header,html.dark nav{border-bottom-color:rgba(160,66,255,.1)!important}html.dark .code-group{border-top:1px solid rgba(160,66,255,.15)!important;border-radius:8px!important}html:not(.dark) .code-group{border:1px solid rgba(160,66,255,.1)!important;border-radius:8px!important;background-color:#faf5ff!important;color:#111827!important}pre{border:0!important}html.dark{--mint-background:#1a1625;--mint-foreground:#e5e7eb;--mint-color-text:#e5e7eb;--mint-color-background:#1a1625;--mint-token-constant:#c4b5fd;--mint-token-string:#6ee7b7;--mint-token-comment:#6b7280;--mint-token-keyword:#c084fc;--mint-token-parameter:#a5b4fc;--mint-token-function:#a78bfa;--mint-token-string-expression:#6ee7b7;--mint-token-punctuation:#9ca3af;--mint-token-link:#c084fc}html:not(.dark) :not(pre)>code{background-color:rgba(160,66,255,.08)!important;color:#6b21a8!important}html:not(.dark) .code-group [role=tab][aria-selected=true],html:not(.dark) .codeblock-dark [role=tab][aria-selected=true],html:not(.dark) button[aria-label*=opy] svg{color:#7c3aed!important}html:not(.dark) .code-group [role=tab]{color:#6b7280!important}html:not(.dark) .code-group [role=tab]:hover>div:first-child{background-color:rgba(160,66,255,.1)!important;color:#7c3aed!important}html:not(.dark) .code-group [role=tab][aria-selected=true]>div:last-child{background-color:#7c3aed!important}html:not(.dark) .codeblock-dark,html:not(.dark) .codeblock-dark [data-component-part=code-block-root]{background-color:#faf5ff!important;color:#111827!important}html:not(.dark) .codeblock-dark [data-fade-overlay=true]{--fade-color-light:#faf5ff!important;--fade-color-dark:#faf5ff!important}[role=listbox],[role=menu],[role=tooltip]{background-color:#fff!important;color:#1f2937!important;border:1px solid rgba(160,66,255,.15);border-radius:8px;box-shadow:0 12px 28px -8px rgba(0,0,0,.18);backdrop-filter:blur(8px)}html.dark [role=listbox],html.dark [role=menu],html.dark [role=tooltip]{background-color:#1a1625!important;color:#e5e7eb!important;border-color:rgba(160,66,255,.25);box-shadow:0 12px 28px -8px rgba(0,0,0,.6)}[role=tooltip] *{color:inherit!important}[class*=navbar]::after,[class*=sidebar]::after,[class*=sidebar]::before,[class*=topbar]::after,header::after,nav[class*=side]::after,nav[class*=side]::before,nav[class*=top]::after{background:0 0!important;background-image:none!important;background-color:transparent!important;display:none!important}[class*=sidebar]>div:first-child{background:0 0!important;background-color:transparent!important;background-image:none!important}#sidebar-content .sticky.top-0{background:0 0!important;background-image:none!important;background-color:transparent!important}[data-nav-tag=Preview]{color:#2563eb!important;background-color:rgba(37,99,235,.1)!important}html.dark [data-nav-tag=Preview]{color:#60a5fa!important;background-color:rgba(96,165,250,.15)!important}[data-nav-tag=New]{color:#16a34a!important;background-color:rgba(22,163,74,.1)!important}html.dark [data-nav-tag=New]{color:#4ade80!important;background-color:rgba(74,222,128,.15)!important}"}],"page":{"pagePath":"essentials/quick-setup","slug":"/essentials/quick-setup","pageMetadata":{"title":"Quick Setup","icon":"bolt","description":null,"href":"/essentials/quick-setup"},"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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Frame,Heading,Icon,Note,OptimizedImage,Step,Steps,Tab,Tabs,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The fastest path to a working Frontic project with real data flowing through it. By the end of this page you’ll have a project, storages, and data you can build against.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create an account and a project`,children:[_jsxs(_components.p,{children:[`Head to the `,_jsx(_components.a,{href:`https://app.frontic.com`,children:`admin app`}),` and sign up. Once you’re in, go to `,_jsx(_components.strong,{children:`Settings → Projects`}),` and click `,_jsx(Icon,{icon:`plus`}),` `,_jsx(_components.strong,{children:`Add Project`}),`. Give it a name and set it `,_jsx(_components.strong,{children:`Active`}),`.`]}),_jsxs(_components.p,{children:[`The admin app then walks you through three setup steps: add at least one `,_jsx(_components.strong,{children:`Locale`}),`, one `,_jsx(_components.strong,{children:`Region`}),` that offers it, and one `,_jsx(_components.strong,{children:`Domain`}),`. Frontic needs all three before it can serve data, and the project stays in these steps until they are done. If you’re unsure, pick your primary market and default language. You can add more later. See `,_jsx(_components.a,{href:`/project-settings/general`,children:`Project Settings`}),` and `,_jsx(_components.a,{href:`/project-settings/domains`,children:`Domains`}),` for the full reference.`]})]}),_jsxs(Step,{title:`Get data in`,children:[_jsx(_components.p,{children:`Pick the route that matches where you are.`}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Connect your stack`,id:`connect-your-stack`,children:[_jsxs(_components.p,{children:[`If you want to wire things up yourself, connect a source through a `,_jsx(_components.a,{href:`/connectors/overview`,children:`Connector`}),`. Shopify, Shopware, commercetools, Akeneo, Storyblok, Contentful, and more are supported - or bring your own via `,_jsx(_components.a,{href:`/connectors/custom`,children:`Custom Integration`}),`.`]}),_jsxs(Frame,{caption:`Pick a pre-built connector or wire up your own through the Custom API`,children:[_jsx(OptimizedImage,{src:`https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=6c0b323de64dd8dc12a684b1dfdfb6c0`,className:`dark:mint-hidden mint-block mint-mx-auto mint-mt-5 mint-mb-5`,style:{maxWidth:`480px`},alt:`Integration picker showing pre-built connectors: Shopware, commercetools, Akeneo, Shopify, Storyblok, Reviews.io, CSV Import, and Custom API`,\"data-og-width\":`1820`,width:`1820`,\"data-og-height\":`1190`,height:`1190`,\"data-path\":`images/essentials/setup/integration-select-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=75ce7d2a6864370d3295db876a11f7c0 280w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=e344abaffaa74e4e7f5254241837862f 560w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=edfd2f0d9ccfa71bc9d0f7b627c07a66 840w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=2a2343f145c2631dac03e72fa62d4e0b 1100w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=bc70a45da9213933e23a794e6f107c62 1650w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=f5a3267faad3166d8f831f02c99fce10 2500w`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=3282adac5b229e0c88431dd2bcb2c772`,className:`mint-hidden dark:mint-block mint-mx-auto mint-mt-5 mint-mb-5`,style:{maxWidth:`480px`},alt:`Integration picker showing pre-built connectors: Shopware, commercetools, Akeneo, Shopify, Storyblok, Reviews.io, CSV Import, and Custom API`,\"data-og-width\":`1820`,width:`1820`,\"data-og-height\":`1190`,height:`1190`,\"data-path\":`images/essentials/setup/integration-select-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=fceae7be420a5ea2eca67369715e59dd 280w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=bc9d626af285610cfbc6f99ced5186df 560w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=d5f5b53d62339ffafcf04b9e4977c26e 840w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=856c10e43069778897bf0b17a3b6db88 1100w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=bd4315389dee134c0b74fb2ee0a41642 1650w, https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=dMyTxpRVUqjjT-VO\u0026q=85\u0026s=e9a4236380776690912fded832b02a98 2500w`})]}),_jsxs(_components.p,{children:[`Once the connector is running, raw records flow into a `,_jsx(_components.strong,{children:`Feed`}),`. From there, set up a `,_jsx(_components.strong,{children:`Data Sync`}),` to map feed data into your `,_jsx(_components.a,{href:`/data-integration/data-storages`,children:`Data Storages`}),`. The `,_jsx(_components.a,{href:`/data-integration/value-composer`,children:`Value Composer`}),` handles the per-field shaping - defining how each target field gets its value from the source.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/essentials/buddy`,children:`Buddy`}),` can help here. Describe the source shape and the target shape, and Buddy will propose a sync configuration you can review and approve.`]})})]}),_jsxs(Tab,{title:`Analyze Storefront`,id:`analyze-storefront`,children:[_jsxs(_components.p,{children:[`Already have a live shop? Paste its URL into the `,_jsx(_components.strong,{children:`Shop Importer`}),` and let Frontic do the rest.`]}),_jsx(_components.p,{children:`Frontic profiles the site automatically - it detects the platform, locales, currencies, navigation structure, categories, and product model. Once the profile is ready, review it and adjust anything that doesn’t look right.`}),_jsx(_components.p,{children:`When you confirm, Frontic provisions the entire project for you: Data Storages, Data Syncs, field mappings, and the initial data import. No manual wiring needed.`}),_jsx(Note,{children:_jsx(_components.p,{children:`The shop importer is available for Shopify and Shopware stores today, with more platforms coming.`})})]})]})]}),_jsxs(Step,{title:`Set up your Context Base`,children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/context-base/overview`,children:`Context Base`}),` is the shared knowledge layer that every agent reads - whether you build in Studio or in your editor with our CLI and MCP. It holds your design system, coding standards, tone of voice, and business context so agents don’t start from zero.`]}),_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Studio`}),` from the sidebar. On a project that hasn’t run it yet, Frontic steers you into `,_jsx(_components.a,{href:`/context-base/setup`,children:`Context Setup`}),` first (it’s rolling out gradually): it reads your storefront, asks a short interview about what it couldn’t work out - what you sell, your brand, your design preferences, your coding conventions - and generates the full context for you. `,_jsx(_components.strong,{children:`Skip for now`}),` is always there if you’d rather come back to it.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can rerun the setup any time (`,_jsx(_components.code,{children:`/init-context`}),`) to update your context\nas the project evolves. See `,_jsx(_components.a,{href:`/context-base/overview`,children:`Context Base`}),` for more.`]})})]}),_jsxs(Step,{title:`You're ready to build`,children:[_jsx(_components.p,{children:`Your project has data in it, Studio knows your conventions, and the backend is live. Pick a route and start shipping.`}),_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Your first feature`,icon:`rocket`,href:`/essentials/your-first-feature`,children:_jsx(_components.p,{children:`A walkthrough that shows you Studio and your editor side by side.`})}),_jsx(Card,{title:`Build in Studio`,icon:`sparkles`,href:`/studio/frontic-studio`,children:_jsx(_components.p,{children:`Open a Studio job and start creating the experience.`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-first-problems`,children:`Common first problems`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The shop importer didn't detect my platform`,id:`the-shop-importer-didnt-detect-my-platform`,children:_jsxs(_components.p,{children:[`The importer currently supports Shopify and Shopware. If your shop runs on a different platform, use the `,_jsx(_components.strong,{children:`Connect your stack`}),` route and pick the matching connector - or a custom integration if there’s no pre-built one.`]})}),_jsx(Accordion,{title:`My feed is empty after connecting a source`,id:`my-feed-is-empty-after-connecting-a-source`,children:_jsxs(_components.p,{children:[`Connectors poll or sync on their own schedule. Give it a minute, then check the feed records view. If nothing shows up, check the connector’s status and credentials in the `,_jsx(_components.strong,{children:`Integrations`}),` section.`]})}),_jsx(Accordion,{title:`My Data Storage fields don't match my feed shape`,id:`my-data-storage-fields-dont-match-my-feed-shape`,children:_jsx(_components.p,{children:`That’s expected. The Data Sync + Value Composer step is where you map and transform. Start with a direct mapping for the fields that match 1:1 and use composer operations for the rest.`})})]})]})}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":{"codeStyling":{"theme":"css-variables"},"config":{},"pageMetadata":{"title":"Quick Setup","icon":"bolt","description":null,"href":"/essentials/quick-setup"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Common first problems","slug":"common-first-problems","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-mx-auto {\n margin-left: auto;\n margin-right: auto\n}\n.mint-mb-5 {\n margin-bottom: 1.25rem\n}\n.mint-mt-5 {\n margin-top: 1.25rem\n}\n.mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"frontic","siteName":"Frontic Docs","title":"Quick Setup - Frontic Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-01T22:42:15.380Z","originalFileLocation":"essentials/quick-setup.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Frontic Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Quick Setup - Frontic Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Frontic Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.frontic.com/essentials/quick-setup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://frontic.mintlify.app/_mintlify/api/og/v2?division=Essentials\u0026amp;title=Quick+Setup\u0026amp;theme=206c460697bb939e13b9c293\u0026amp;signature=13cea6750c0c37aaf8d05cb22dacdebaf3c27313dd2acb7497b8c8067355ce65\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Quick Setup - Frontic Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://frontic.mintlify.app/_mintlify/api/og/v2?division=Essentials\u0026amp;title=Quick+Setup\u0026amp;theme=206c460697bb939e13b9c293\u0026amp;signature=13cea6750c0c37aaf8d05cb22dacdebaf3c27313dd2acb7497b8c8067355ce65\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/frontic/J-QaW07dTW_FQ00e/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Frontic Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#a855f7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.frontic.com/essentials/quick-setup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/essentials/quick-setup.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.frontic.com/#organization\",\"name\":\"Frontic Docs\",\"url\":\"https://docs.frontic.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/frontic/QEEg-J3fIyHJ_Wyh/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=QEEg-J3fIyHJ_Wyh\u0026q=85\u0026s=36391b9f3546193a73f97d7b6ee40463\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.frontic.com#website\",\"name\":\"Frontic Docs\",\"url\":\"https://docs.frontic.com\",\"publisher\":{\"@id\":\"https://docs.frontic.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.frontic.com/essentials/quick-setup#webpage\",\"url\":\"https://docs.frontic.com/essentials/quick-setup\",\"name\":\"Quick Setup\",\"dateModified\":\"2026-11-01T22:42:15.380Z\",\"isPartOf\":{\"@id\":\"https://docs.frontic.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.frontic.com/essentials/quick-setup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.frontic.com/essentials/quick-setup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Essentials\",\"item\":\"https://docs.frontic.com/essentials/what-is-frontic\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Quick Setup\",\"item\":\"https://docs.frontic.com/essentials/quick-setup\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.frontic.com/essentials/quick-setup#article\",\"headline\":\"Quick Setup\",\"name\":\"Quick Setup\",\"url\":\"https://docs.frontic.com/essentials/quick-setup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.frontic.com/essentials/quick-setup#webpage\"},\"dateModified\":\"2026-11-01T22:42:15.380Z\",\"publisher\":{\"@id\":\"https://docs.frontic.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.frontic.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Frontic Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Frontic Docs","nav":{"global":{},"tabs":[{"tab":"Documentation","groups":[{"group":"Essentials","pages":[{"title":"What is Frontic","icon":"house","description":null,"href":"/essentials/what-is-frontic"},{"title":"Quick Setup","icon":"bolt","href":"/essentials/quick-setup"},{"title":"Your First Feature","icon":"rocket","description":null,"href":"/essentials/your-first-feature"},{"title":"Core Concepts","icon":"book","href":"/essentials/core-concepts"},{"title":"AI Buddy","icon":"user-astronaut","href":"/essentials/buddy"},{"title":"Keyboard Shortcuts","icon":"keyboard","href":"/essentials/keyboard-shortcuts"},{"title":"Your turn","sidebarTitle":"Your turn","icon":"bell","href":"/essentials/your-turn"}]},{"group":"Commerce Concepts","pages":[{"title":"Product Models","icon":"boxes-stacked","href":"/commerce-concepts/product-models"},{"title":"Multi-Channel \u0026 Multi-Region","icon":"globe","href":"/commerce-concepts/multi-channel-region"},{"title":"URLs, Redirects \u0026 SEO","icon":"link","href":"/commerce-concepts/urls-seo"}]},{"group":"Data Integration","pages":[{"title":"Overview","icon":"circle-nodes","href":"/data-integration/overview"},{"title":"Ingest Data","icon":"gears","iconType":"solid","href":"/data-integration/ingest"},{"title":"Data Storages","icon":"database","href":"/data-integration/data-storages"},{"title":"Value Composer","icon":"wand-magic-sparkles","href":"/data-integration/value-composer"}]},{"group":"API Builder","pages":[{"title":"Overview","icon":"sitemap","href":"/api-builder/overview"},{"title":"Detail Blocks","icon":"cube","iconType":"solid","href":"/api-builder/blocks"},{"title":"Search Listings","icon":"cubes","iconType":"solid","href":"/api-builder/listings"},{"title":"Page URLs","icon":"map","href":"/api-builder/pages"},{"title":"Menu Trees","icon":"list-tree","iconType":"solid","href":"/api-builder/trees"}]},{"group":"Release Control","pages":[{"title":"Overview","icon":"code-merge","tag":"Plus","href":"/releases/overview"},{"title":"What's in a Release","icon":"list-check","href":"/releases/what-flows-through"},{"title":"Release Flow","icon":"layer-group","href":"/releases/release-flow"}]},{"group":"Build in Frontic","pages":[{"title":"Overview","icon":"hammer","href":"/build/overview"},{"group":"Frontic Studio","pages":[{"title":"Frontic Studio","icon":"sparkles","iconType":"solid","href":"/studio/frontic-studio"},{"title":"Workspace","icon":"laptop-code","href":"/studio/workspace"},{"title":"GitHub Integration","icon":"github","href":"/studio/github-integration"},{"title":"Studio Settings","icon":"gear","href":"/studio/settings"}]},{"group":"Experience Designer","pages":[{"title":"Overview","icon":"palette","tag":"Preview","href":"/designer/overview"},{"title":"Building an experience","icon":"pen-ruler","tag":"Preview","href":"/designer/building"},{"title":"Publishing","icon":"rocket","tag":"Preview","href":"/designer/publishing"}]}]},{"group":"Build in Your IDE","pages":[{"title":"Overview","icon":"code","href":"/ide/overview"},{"title":"Project Context","icon":"brain","href":"/ide/project-context"},{"title":"Frontic CLI","icon":"terminal","href":"/ide/frontic-cli"},{"title":"MCP Tools","icon":"microchip-ai","href":"/ide/mcp-tools"}]},{"group":"Context Base","pages":[{"title":"Overview","icon":"brain","tag":"Grow","href":"/context-base/overview"},{"title":"Context Setup","sidebarTitle":"Setup","icon":"wand-magic-sparkles","tag":"Preview","href":"/context-base/setup"},{"title":"Skills","icon":"star","href":"/context-base/skills"},{"title":"Rules","icon":"gavel","href":"/context-base/rules"},{"title":"Commands","icon":"terminal","href":"/context-base/commands"},{"title":"Guides","icon":"book","href":"/context-base/guides"},{"title":"Design Library","icon":"palette","href":"/context-base/design-library"}]},{"group":"Project Settings","pages":[{"title":"General","icon":"folder-gear","href":"/project-settings/general"},{"title":"Scopes","icon":"layer-group","href":"/project-settings/scopes"},{"title":"Regions","icon":"earth-americas","href":"/project-settings/regions"},{"title":"Locales","icon":"language","href":"/project-settings/locales"},{"title":"Domains","icon":"globe","href":"/project-settings/domains"},{"title":"Data Types","icon":"table","href":"/project-settings/data-types"},{"title":"Agents","icon":"robot","href":"/project-settings/agents"}]},{"group":"Administration","pages":[{"title":"Teams","icon":"building","href":"/admin/teams"},{"title":"Members \u0026 Roles","icon":"users","href":"/admin/members-and-roles"},{"title":"Billing \u0026 Plans","icon":"credit-card","href":"/admin/billing-and-plans"},{"title":"Limits","icon":"clock","href":"/admin/limits"}]}]},{"tab":"Connectors","pages":[{"title":"Connectors","href":"/connectors/overview"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/overview"}]}]},"basePath":"","title":"Quick Setup - Frontic Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DW6UFrUy.js","DynamicMarkdown-B62XqCSI.js","zoom-image-lightbox-eHyQ0tlO.js","lightbox-handle-r17bVUz3.js"]}