QuickstartGet a sample Subframe page running in your local environment in 1 minute.
Build your first page
Sync your componentsThis is a one-way sync from Subframe to your code base. It will add the components needed by your page or update them if you've made changes in Subframe since your last sync. Copy your page codeCopy and paste the code below into src/app/page.tsx in your code editor. We use a copy / paste workflow for pages because you will modify this code with the custom business logic of your app."use client";
import React from "react";
import { Alert } from "@/subframe/components/Alert";
import { Button } from "@/subframe/components/Button";
function InstallationSuccessPage() {
return (
<div className="container max-w-none flex h-full w-full flex-col items-center gap-8 bg-default-background py-12">
<img
className="h-6 flex-none object-cover"
src="https://res.cloudinary.com/subframe/image/upload/v1711417518/shared/fdb8rlpzh1gds6vzsnt0.svg"
/>
<div className="flex w-full max-w-[576px] flex-col items-center gap-4">
<div className="flex w-full flex-col items-center gap-4 rounded-md bg-brand-100 px-12 py-12">
<span className="font-['Inter'] text-[40px] font-[600] leading-[40px] text-default-font">
🥳
</span>
<div className="flex flex-col items-center gap-1">
<span className="text-heading-3 font-heading-3 text-default-font">
Nice work, you're all set up!
</span>
<span className="text-body font-body text-subtext-color">
Get started building your own UI below
</span>
</div>
</div>
<div className="flex w-full items-center gap-4">
<Alert
className="h-auto grow shrink-0 basis-0 self-stretch"
icon="FeatherTerminalSquare"
title="Components are synced"
description="Run the CLI anytime you add or edit components"
/>
<Alert
className="h-auto grow shrink-0 basis-0 self-stretch"
icon="FeatherClipboardCheck"
title="Pages are copy & pasted"
description="Export your code to a .tsx file and start developing"
/>
</div>
<div className="flex w-full flex-col items-center">
<div className="flex w-full flex-col items-center gap-6 bg-default-background px-6 py-6">
<div className="flex w-full flex-col items-center">
<div className="flex w-full items-start gap-4">
<div className="flex flex-col items-center self-stretch pt-1.5">
<div className="flex h-2.5 w-2.5 flex-none flex-col items-start gap-2 rounded-full bg-brand-600" />
<div className="flex w-0.5 grow shrink-0 basis-0 flex-col items-start gap-2 bg-brand-600" />
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-1 pb-9">
<div className="flex w-full flex-col items-start gap-1">
<span className="text-body-bold font-body-bold text-default-font">
Build your first page
</span>
<span className="w-full text-caption font-caption text-subtext-color">
Choose from our designer-curated templates, or start from
scratch.
</span>
</div>
</div>
</div>
<div className="flex w-full items-start gap-4">
<div className="flex flex-col items-center self-stretch">
<div className="flex h-1.5 w-0.5 flex-none flex-col items-start gap-2 bg-brand-600" />
<div className="flex h-2.5 w-2.5 flex-none flex-col items-start gap-2 rounded-full bg-brand-600" />
<div className="flex w-0.5 grow shrink-0 basis-0 flex-col items-start gap-2 bg-brand-600" />
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-2 pb-9">
<div className="flex w-full flex-col items-start gap-1">
<span className="text-body-bold font-body-bold text-default-font">
Export page code
</span>
<span className="w-full text-caption font-caption text-subtext-color">
Copy & paste generated code to your project, just like
you did here.
</span>
</div>
</div>
</div>
<div className="flex w-full items-start gap-4">
<div className="flex flex-col items-center self-stretch">
<div className="flex h-1.5 w-0.5 flex-none flex-col items-start gap-2 bg-brand-600" />
<div className="flex h-2.5 w-2.5 flex-none flex-col items-start gap-2 rounded-full bg-brand-600" />
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-4">
<div className="flex w-full flex-col items-start gap-1">
<span className="text-body-bold font-body-bold text-default-font">
Write your business logic
</span>
<span className="text-caption font-caption text-subtext-color">
The code is all yours! Refactor or add custom code to your
pixel-perfect UI.
</span>
</div>
<Button
icon="FeatherCode"
onClick={(event: React.MouseEvent<HTMLButtonElement>) => {}}
>
Try adding an onClick handler to me!
</Button>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
);
}
export default InstallationSuccessPage;
Start the serverOpen your app locally and verify that everything is working properly. You can now export your designs to code! Code structure
Depending on which exact framework and version you're using, your code structure will look something like this:
1.
2│── .subframe
3│ │── access-token
4│ └── sync.json
5├── public
6│ └── ...
7├── src
8│ ├── app
9│ │ ├── layout.tsx
10│ │ ├── page.tsx
11│ │ ├── globals.css
12│ │ └── favicon.ico
13│ └── subframe
14│ ├── components
15│ │ ├── Alert.tsx
16│ │ ├── Button.tsx
17│ │ └── ...
18│ ├── layouts
19│ │ ├── DefaultPageLayout.tsx
20│ │ ├── DialogLayout.tsx
21│ │ └── ...
22│ ├── index.ts
23│ └── tailwind.config.js
24├── .gitignore
25├── next.config.js
26├── package.json
27├── package-lock.json
28├── postcss.config.js
29├── tailwind.config.js
30└── tsconfig.json
31
- Project sync settings are found in
.subframe. The access-token file is automatically added to your .gitignore - Fonts used by your theme are loaded in
src/app/layout.tsx - Pages you design in Subframe go in
src/app/page.tsx and subpaths that you create in the future src/app/**/*/page.tsx - The Subframe component library and your custom components are synced into
src/subframe/components - Subframe layouts are found in
src/subframe/layouts - Your Subframe theme is setup in
src/subframe/tailwind.config.js - Some minor Subframe specific configuration occurs in
tailwind.config.js and tsconfig.json
