# Starter templates

> Start a prototype with your team's preferred setup already in place.
> URL: https://artor.app/docs/templates

Start a prototype with your team's preferred components and setup already in place.
A template saves you from repeating the same preparation for every project.

## Use a template

From your terminal, list the team's templates and choose one:

```bash
artor template list
artor init --template dashboard --name "My App"
```

Artor creates a folder for the new prototype, links it to your organization, installs what it
needs, and adds the team's [skills](https://artor.app/docs/skills). You can then edit it and
[publish](https://artor.app/docs/publishing). New to the terminal? Follow [Installing the CLI](https://artor.app/docs/install-cli).

To start in the current folder or skip installation:

```bash
artor init --template dashboard --here
artor init --template dashboard --no-install
```

**Warning:** 
  Existing local files are never overwritten. A template only adds files that are missing.

## Create a template (admin)

From a project folder set up the way you want:

```bash
artor template push --name "Dashboard" --slug dashboard --desc "Our standard dashboard starter"  # admin access required
```

The slug, `dashboard`, is the short name teammates use with `artor init --template`.
Running this command again with the same slug **replaces the shared template** for future
projects. It does not update projects that already used it.

Sensitive files such as environment files and credentials are excluded automatically. Check
that the remaining content is suitable for everyone in the organization before sharing it.

## Dashboard

Open **Templates** to browse your organization's starters. People with permission to manage
templates can upload a zip or tgz file, or remove a template the team no longer needs.
Removing a template does not delete prototypes created from it.

## Who can manage templates

Owners and admins manage templates by default. An admin can allow **All members** under
**Settings → Skills & Templates**. This is the same setting used for
[skills](https://artor.app/docs/skills#permission-gate).

## Related

- [Skills](https://artor.app/docs/skills) — shared instructions included in new projects
- [Private registry](https://artor.app/docs/registry) — use your team's private components
- [CLI reference](https://artor.app/docs/cli#starter-templates) — template commands
