# Index

Brando 0.55.0 — installed

# Your site is up. Now make it yours.

Every word on this page is content, not template. It was seeded by `mix brando.setup` — six blocks, seven modules and a footer fragment, all of which you can rewrite, reorder or delete from the admin.

[Open the admin](https://demo.brando.b-y.no/admin)[Read the guides ↗](https://hexdocs.pm/brando)

One

page, published at /

Six

blocks on this page

Seven

modules you can edit

One

menu, under Navigation

01 — Quick start

## Three moves to your own page.

About five minutes

01

### Edit this page

Pages → Index holds the blocks you're reading. Change a heading, save, reload.

/admin/pages

02

### Write a module

Your markup, with named refs the editor fills in. You keep the HTML.

{% ref refs.title %}

03

### Model your data

A blueprint gives you schema, migration, admin forms and listings at once.

mix brando.gen

02 — What's in the box

## Everything you just installed.

Each links to its guide

[ContentBlock editorModules, multi-blocks, containers and live preview of your real templates.block\_editor →](https://hexdocs.pm/brando/block_editor.html)[SchemaBlueprintsOne definition becomes the schema, migration, admin forms and listings.blueprints →](https://hexdocs.pm/brando/blueprints.html)[MediaImages \&amp; filesFocal points, generated sizes, CDN delivery and lazy-loaded srcsets.media →](https://hexdocs.pm/brando/media.html)[WorkflowRevisionsEvery save is kept. Schedule publishing ahead, roll back whenever.revisions →](https://hexdocs.pm/brando/revisions.html)[Reachi18n \&amp; SEOPer-language content, identity, meta, JSON-LD and generated sitemaps.i18n →](https://hexdocs.pm/brando/i18n.html)[DeliveryStatic exportRender the whole site to files and deploy it anywhere you like.deployment →](https://hexdocs.pm/brando/deployment.html)

03 — Tips & tricks

## Easy to miss on day one.

01

### Live preview as you type

Wire up `LivePreview` and the editor renders your real templates while editing.

02

### Setup is idempotent

`mix brando.setup` skips every step whose result already exists.

03

### Modules are portable

Export them as JSON and import them into the next project.

04

### Own the markup

Change how any block renders in `villain/parser.ex`.

05

### Menus are content

The navigation above lives under Navigation, never in a template.

06

### Design tokens, not guesses

`@space` and `@column` come straight from your artboard.

04 — The toolbox

## Everything Brando adds to mix.

Run any of these in this directory

Brando ships around forty mix tasks. These are the ones you will actually reach for. Anything marked ★ writes a reviewable plan first — it shows you the diff and waits for you to accept it. Add `--help` to any task for its full options.

\~ — zsh Brando 0.55.0

$ mix help brando

Setup

brando.installInstall Brando into a Phoenix application

brando.setupAssets, database, superuser and seeds in one pass

brando.gen.seedsSeed default content for a new installation

brando.assets.setupLink the JS sources and build frontend assets

Generate

brando.gen.blueprintDefine a new content type

brando.genSchema, admin, forms and API from a blueprint

brando.gen.blueprint\_migrationA reversible migration and snapshot

brando.gen.adminCreate another admin user

brando.gen.languagesIdentity and SEO rows for new languages

brando.gen.sitemapA CMS sitemap module

Content

brando.modulesExport, plan and import module definitions

brando.entries.resaveRe-render every entry after a template change

brando.identifiers.syncRepair missing or stale identifiers

Ship

brando.migrateRun public or tenant migrations

brando.static.buildBuild and digest static files

brando.static.deployUpload static files to the CDN

brando.ssgRender the whole site to static files

brando.gen.releaseRelease helpers and mix release config

Upgrade

brando.upgradeApply versioned source upgrades

brando.migrate55Move application source from 0.54 to 0.55

\# 20 shown · run \`mix help --search brando.\` for the rest

$

↹ complete⏎ run--help options for any taskelixir 1.20.4 · otp 28

### Nothing writes blindly

Starred tasks build an Igniter plan, print the diff and wait. Answer `n` and nothing touched your source.

### Start with a blueprint

Describe the content type once; `mix brando.gen` turns it into schema, admin and API.

### Rerunning is safe

`brando.setup` skips any step whose result already exists, so it is fine to run it twice.

### After a template change

`brando.entries.resave` re-renders stored content so the new markup reaches published pages.

★ shows a diff first\
 → full list: mix help --search brando.

05 — Last thing

## When this page has served its purpose, delete it.

Nothing here is special. It is a page, seven modules and a fragment — all removable from the admin, none of it wired into your templates.

[Go to Pages](https://demo.brando.b-y.no/admin/pages)
