Brand

Upload your logo, mark and favicon as SVG files in DS Manager, add dark mode versions, set the logo height, see how files are sanitized, and where your brand name and logo appear in Pro Blocks.

Last updated 13 Nov 2026DS Manager

The Brand page holds three SVG slots: your logo, your mark and your favicon. They show on the canvas previews and in Pro Blocks, and they publish with your system as files plus a ready-made Logo component.

  1. Open Brand in the left nav.
  2. In the Logo slot, click Choose SVG in the File (light) row, or drop an SVG file onto the row. The Favicon slot has a single File row.
  3. DS Manager cleans the file and shows it on a light and a dark surface side by side. The row shows the file's own name.
The Brand page in dark mode with a logo and a mark uploaded, File (light), File (dark), Dark fallback and Height in the right rail with a light and a dark preview of each, and the assets in their slots and in a product header on the canvas

To swap a file, click its row, or open the ⋮ menu at the end of the row and choose Replace SVG. The same menu removes the file: Remove logo, Remove dark logo, Remove mark and so on. Remove all brand assets in the command menu clears all three slots. The page header counts how many of the three slots are filled.

The three slots

SlotWhat it is forInstalls to
LogoThe full lockup, mark plus wordmarkpublic/logo.svg, and public/logo-dark.svg for a dark file
MarkThe square glyph on its own, for tight spacespublic/logo-mark.svg, and public/logo-mark-dark.svg for a dark file
FaviconThe browser-tab icon. Keep it legible at 16pxapp/icon.svg

You do not need all three. Where a preview asks for the logo and you only uploaded a mark, it draws the mark, and the other way round.

The canvas has two sections. Brand assets shows each slot as a card, uploaded or still empty. In context places them where you judge a logo: a product Header, a Sign in card and a Favicon in a browser tab.

Light and dark

Logo and Mark each take two files: File (light) and File (dark). Upload a dark file when your logo needs different colors on a dark background. Dark mode then draws the dark file, and light mode the light one.

With only a light file, the Dark fallback row decides what dark mode draws:

  • Light draws the light file as it is.
  • Text draws it in the text color, so a black logo turns white on a dark background.

A one-color logo starts on Text, and a logo with more colors starts on Light. Dark fallback goes away once you upload a dark file.

Each slot previews what it draws on a light and a dark surface, and the canvas's light and dark toggle shows the whole page in either mode.

DS Manager inlines your SVG markup in the page, so CSS reaches inside it. A shape filled with currentColor takes the surrounding text color, which makes a one-color mark read on both light and dark backgrounds. The published Logo component inlines the same markup, so this works in your project too.

Height

Logo and Mark each have a Height row once there is a file to draw. It sets how tall the logo is drawn. The defaults are 20px for the logo, the height of a navbar logo, and 40px for the mark. You can set anything from 8 to 200px. A dot next to Height means you changed it; click it to go back to the default.

The height applies in every Pro Blocks block and in your installed project. Blocks that draw the logo at another size scale by the same ratio, and a height you set on one block yourself still wins there. An SVG that has no size of its own, or is set to width="100%", keeps its own proportions in the block, scaled with Height, instead of filling the row.

SVG rules and sanitizing

An SVG is a document that can carry scripts and links, and your logo ends up in other people's projects. DS Manager cleans every file before it is stored, using an allowlist of what a logo needs.

  • SVG only, up to 256 KB. A full lockup is usually a few KB.
  • The file must be valid XML with an <svg> root element.
  • Removed with everything inside them: <script>, <foreignObject>, <iframe>, embedded images (<image>) and animation elements.
  • Removed attributes: event handlers such as onload and onclick, and links to anything outside the file. Internal #fragment references stay.
  • Links (<a>) are unwrapped: the link goes, the artwork inside stays.
  • <style> blocks stay, as long as they do not load anything from outside the file. Logos exported from Illustrator and Figma keep their class-based colors.
  • Comments and processing instructions are removed.

After an upload, the slot lists what it took out under "Stripped on the way in:". If a file is rejected, the slot says why: it is empty, over the size limit, not valid SVG, has a root other than <svg>, or had nothing left to draw after cleaning. A too-large file usually means an embedded bitmap. Export the artwork again as plain SVG with outlines and paths.

Brand name

The Brand page has no name field. Your brand name is your system's name.

  • The canvas prints it on the Sign in card ("Sign in to Acme") and in the favicon tab's title.
  • Pro Blocks footers print it in their copyright line. An installed footer has the name written in as plain text.
  • A system with no name, or still called "Untitled system", gets "Your company" instead.

To change it, open the system switcher in the top bar, choose Manage systems… and rename the system. Names can be up to 100 characters. Renaming does not move your registry address.

Your logo in Pro Blocks

The Pro Blocks that draw a logo (the navbars, the footers, and a few comparison and coming-soon blocks) use your uploaded logo, or the mark when that is all you uploaded. With nothing uploaded they draw a neutral placeholder. Logo clouds keep their generic placeholder logos, since those stand for your customers.

Pro Blocks and Lint sit under Brand in the left nav. See Pro Blocks and Lint locks.

What publishes

When you publish, each uploaded asset becomes a file at the path in the table above, and DS Manager generates components/logo.tsx. It exports a Logo component, plus LogoMark when your mark is a different file. The component carries both the light and the dark drawing and your heights. The component is regenerated on every publish, so edit the asset in DS Manager, not the file.

The favicon targets app/icon.svg, which the Next.js App Router serves as the site icon with no extra setup. In a project that uses a src/ directory, it still lands in app/icon.svg at the project root, so move it to src/app/icon.svg.