> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frontic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Setup

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.

<Steps>
  <Step title="Create an account and a project">
    Head to the [admin app](https://app.frontic.com) and sign up. Once you're in, go to **Settings → Projects** and click <Icon icon="plus" /> **Add Project**. Give it a name and set it **Active**.

    Then open the project settings and add at least one **Region** and one **Locale** — Frontic needs these before it can serve data. If you're unsure, pick your primary market and default language. You can add more later. See [Project Settings](/project-settings/general) for the full reference.
  </Step>

  <Step title="Get data in">
    Pick the route that matches where you are.

    <Tabs>
      <Tab title="Connect your stack">
        If you want to wire things up yourself, connect a source through a [Connector](/connectors/overview). Shopify, Shopware, commercetools, Akeneo, Storyblok, Contentful, and more are supported — or bring your own via [Custom Integration](/connectors/custom).

        <Screenshot name="essentials/setup/integration-select" alt="Integration picker showing pre-built connectors: Shopware, commercetools, Akeneo, Shopify, Storyblok, Reviews.io, CSV Import, and Custom API" caption="Pick a pre-built connector or wire up your own through the Custom API" view="modal" />

        <Frame caption="Pick a pre-built connector or wire up your own through the Custom API">
          <img src="https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-light.png?fit=max&auto=format&n=dMyTxpRVUqjjT-VO&q=85&s=6c0b323de64dd8dc12a684b1dfdfb6c0" className="dark:hidden block mx-auto mt-5 mb-5" style={{ maxWidth: "480px" }} alt="Integration picker showing pre-built connectors: Shopware, commercetools, Akeneo, Shopify, Storyblok, Reviews.io, CSV Import, and Custom API" width="1820" height="1190" data-path="images/essentials/setup/integration-select-light.png" />

          <img src="https://mintcdn.com/frontic/dMyTxpRVUqjjT-VO/images/essentials/setup/integration-select-dark.png?fit=max&auto=format&n=dMyTxpRVUqjjT-VO&q=85&s=3282adac5b229e0c88431dd2bcb2c772" className="hidden dark:block mx-auto mt-5 mb-5" style={{ maxWidth: "480px" }} alt="Integration picker showing pre-built connectors: Shopware, commercetools, Akeneo, Shopify, Storyblok, Reviews.io, CSV Import, and Custom API" width="1820" height="1190" data-path="images/essentials/setup/integration-select-dark.png" />
        </Frame>

        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](/data-integration/data-storages). The [Value Composer](/data-integration/value-composer) handles the per-field shaping — defining how each target field gets its value from the source.

        <Tip>
          [Buddy](/essentials/buddy) can help here. Describe the source shape and the target shape, and Buddy will propose a sync configuration you can review and approve.
        </Tip>
      </Tab>

      <Tab title="Analyze Storefront">
        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.

        <Screenshot name="essentials/setup/shop-importer" alt="Shop Importer wizard profiling a live shop" skip="true" />

        <Note>
          The shop importer is available for Shopify and Shopware stores today, with more platforms coming.
        </Note>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Set up your Context Base">
    The [Context Base](/context-base/overview) 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 and hit the setup button on the landing page. Studio walks you through a short interview — what you sell, your brand, your design preferences, your coding conventions — and generates the full context for you.

    <Tip>
      You can rerun the setup any time (`/init-context`) to update your context
      as the project evolves. See [Context Base](/context-base/overview) for more.
    </Tip>
  </Step>

  <Step title="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.

    <CardGroup cols={2}>
      <Card title="Your first feature" icon="rocket" href="/essentials/your-first-feature">
        A walkthrough that shows you Studio and your editor side by side.
      </Card>

      <Card title="Build in Studio" icon="sparkles" href="/studio/frontic-studio">
        Open a Studio job and start creating the experience.
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Common first problems

<AccordionGroup>
  <Accordion title="The shop importer didn't detect my platform">
    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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>
