Vistralo/Help/Editing

The Visual brief

What a Visual brief contains, how to edit it, and why some of its claims say "likely".

A Visual brief is what you get from analysing a website. It is a written description of a page, with the captures it was written from.

What is in it

  • Screenshots of the page at desktop width, and at phone width if you asked for it.
  • Notes on the page's structure, its type, its motion and interaction.
  • What the page is built with: the libraries, fonts and effects found when its code was read.

Open the project and go to the "Visual brief" tab to read it.

What "likely" means in a brief

A statement that the page uses a particular library is made flatly only when the page's code showed it. Where the captures suggest something and the code did not confirm it, the brief says "likely". Treat those as leads to check.

Editing it

The tab has two views, "Read" and "Edit". "Read" shows the brief as a document; on a wide screen its sections are listed beside it under "In this brief", and choosing one jumps to it.

  1. Press "Edit". The brief opens as Markdown in a field labelled "Brief in Markdown".
  2. Change what you like. "Unsaved changes" shows until you save.
  3. Press "Save brief". You see "Visual brief saved."
  4. Press "Read" to see it as a reader will.

"Copy" puts the whole brief on your clipboard as Markdown, ready to paste into a ticket or a document.

Sharing it

A share link on a website project shows the brief, read-only, to anyone who has the link. See Share links and expiry.

Handing it to a builder

"Download files" packs the brief with the captures. See Files and the download kit.

Still stuck? Write to contact@vistralo.com and say what you did and what you saw. Or go back to all help articles.