Create-built-app NPM

Create Built App

The official command line tool for creating Built.js themes, plugins and sites.

Publishing this library

npm publish

Using the library in a theme or plugin project

Publishing a theme or plugin

The publish command allows you to import a theme or plugin into Built Studio.

npx create-built-app publish [options]

Options

--type
- Specifies the type of entity to publish. Accepted values are theme or plugin (Default: theme).
- Example:
```
npx create-built-app publish --type plugin
```

Updating a theme or plugin

The update command applies changes you make to the data files in public/data directory of your theme or plugin. It includes options to update screenshots for all sections and specify the port number of the Next.js app.

Usage

npx create-built-app update [options]

Options

--plugins
- Updates plugins in the theme based on the array of plugins in public/data/theme.json.
- Example:
```
npx create-built-app update --plugins
```
--screenshots
- Updates screenshots for all sections in the theme or plugin.
- Example:
```
npx create-built-app update --screenshots
```
-p, --port <number>
- Specifies the port number of the running Next.js app when taking screenshots. This is useful if the app is running on a custom port other than the default (e.g., 3000).
- Example:
```
npx create-built-app update --screenshots --port 4000
```

Creating screenshots

Screenshots of each of the sections of your theme will be used to display the section in Built Studio. You can automate the creation and hosting of screenshots of your sections:

Prerequisites

In your Next.js project root, create a .env file with your Cloudinary configuration:

CLOUDINARY_CLOUD_NAME=your-cloud-name-here
CLOUDINARY_API_KEY=your-api-key-here
CLOUDINARY_API_SECRET=your-secret-here

Ensure you have a public/data/sections.json file with your sections:

{
  "sections": [
    {
      "name": "heroSection",
      "defaultTemplate": {
        "name": "cover1"
      }
    }
  ]
}

In components/templates, ensure you have a template (React component for the section) which has the id with the name of the section's defaultTemplate:

// ...
export default function Cover1({ content }: Cover1Props) {
  // ...
  return (
    <section id="cover1">
        // ...
    </section>
    )
}

Creating templates

You can automate the creation of templates (React components for sections) using OpenAI API.

Prerequisites

In your Next.js project root, create a .env file with your OpenAI configuration:

OPENAI_API_KEY=your-api-key-here
OPENAI_MODEL=gpt-4  # Optional, defaults to gpt-4

Ensure you have a public/data/sections.json file with your sections:

{
  "sections": [
    {
      "name": "heroSection",
      "description": "A hero section with heading, subheading, and CTA button",
      "templates": []
    }
  ]
}

What it does

Finds the section(s) in your project's sections.json file
Generates Next.js component(s) using OpenAI based on:
- The section description
- Custom UI prompt (if provided)
Creates the component file(s) in your project's components/<category>/templates/
Updates your project's public/data/templates.json with the new template metadata
Updates the section's templates array in sections.json

Usage

Generate templates in two ways:

Generate a single template from a section: NOTE: The value of the --section flag must equal the name of a section in public/data/sections.json.

npx create-built-app create template --section <sectionName>

Generate templates for all sections:

npx create-built-app create template

Options

--section <name>: Section name to use as reference (optional)
--prompt <description>: Custom UI description for the template(s)
--design-system <type>: Design system to use (options: 'basic' or 'shadcn', defaults to 'basic')

Custom UI Descriptions

You can provide custom UI descriptions in two ways:

For a single section:

npx create-built-app create template --section heroSection --prompt "A modern hero section with gradient background, animated text, and floating elements"

For all sections in theme (applies the same UI style to all generated components):

npx create-built-app create template --prompt "Modern, minimalist design with subtle animations and rounded corners"

Specifying a design system

Choose between two design systems:

Basic (default):

Custom CSS variables for colors and typography
Consistent spacing and border radius
Flexible accent color system
Comprehensive typography scale

shadcn:

npx create-built-app create template --design-system shadcn

Integration with shadcn/ui components
Consistent theming with shadcn variables
Standardized border radius and spacing

Using the Library Locally

Follow the steps below:

Steps

Create a global symlink to your library: Run the following command in your library folder:

npm link

This will create a global symlink to your library.

Make Changes: Edit the TypeScript files in your local library.
Watch and Compile the Changes: Run this to continuously watch for changes to the TypeScript files and recompile:

npm run watch

Navigate to the project where you want to use the library:

cd /path/to/your/local/project

Then link the global symlink to your project:

npm link create-built-app

To unlink:

npm unlink -g create-built-app

Troubleshooting

If you get:

sh: /opt/homebrew/bin/built: Permission denied

You can try unlinking and linking create-built-app, and if that doesn't work, do:

rm -f /opt/homebrew/bin/built

npm install -g create-built-app

If you get:

sh: built: command not found

Do:

npm install -g create-built-app

builtjs cli

@babel/parser axios cloudinary colors commander conf dotenv fs-extra glob inquirer kebab-case lodash nanoid next-sanity openai pluralize prettier ps-list puppeteer

@everything-registry/sub-chunk-1402

4 months ago

3 months ago

4 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

8 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

11 months ago

12 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

12 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

12 months ago

11 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

12 months ago

11 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago