Demo Static site: 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 Read the guides ↗

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
Content

Block editor

Modules, multi-blocks, containers and live preview of your real templates.

block_editor → Schema

Blueprints

One definition becomes the schema, migration, admin forms and listings.

blueprints → Media

Images & files

Focal points, generated sizes, CDN delivery and lazy-loaded srcsets.

media → Workflow

Revisions

Every save is kept. Schedule publishing ahead, roll back whenever.

revisions → Reach

i18n & SEO

Per-language content, identity, meta, JSON-LD and generated sitemaps.

i18n → Delivery

Static export

Render the whole site to files and deploy it anywhere you like.

deployment →
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 task elixir 1.20.4 · otp 28
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