DREAL Museums — partner kit
===========================

Everything here may be used to promote DREAL Museums on your own website,
brochures and social channels. If you need something that is not in this kit,
write to support@dreal.co and we will send it.

Contents
--------

  about.md                 What DREAL Museums is, in English, in three lengths —
                           one line, about 50 words, about 120 words — plus the
                           facts and what is worth telling a traveller.

  copy/<lang>.txt          The site and chapter text in 11 languages,
                           word for word as the app shows it. Paste it as it is.

  photography/             Photographs, JPEG.
    hero.jpg               2560 wide. The wide image for a page header.
    <site>.jpg             Square, 1024px or larger. One per site.

  film/                    Six-second films, MP4, portrait 720x1280, WITH SOUND.
    <site>.mp4             Loops cleanly. Autoplay it muted; browsers block
                           autoplay with sound, and every one of these is
                           designed to read with the sound off.
    <site>-poster.jpg      The frame to show before the film plays. Set it as
                           the `poster` on your video element, or use it on its
                           own if you would rather not carry video.

  snippets/<lang>.html     ⭐ START HERE. Open one of these in a browser. It
                           shows every ready-made block at full size, with the
                           code for each in a box underneath. Copy a box, paste
                           it into your page, done.

                           There are six shapes, so one of them fits your slot:

                             Compact, four sites     320x320, a small slot
                             Compact, photograph     320x360, a small slot
                             Tall, four sites        a sidebar or narrow column
                             Wide, four sites        a full content column
                             Tall, photograph        the lightest of the tall ones
                             Wide, photograph        a banner strip

                           ⚠️ The two COMPACT blocks leave out the line saying a
                           connection is needed at the sites — there is no room
                           for it. If you use one, please say it in your own
                           words nearby.

                           The wide ones fold to fit a narrow column on their
                           own — you do not have to pick by screen size.

  store/
    links.txt              The two store URLs, if you need them. The ready-made
                           blocks do not use them — see below.

  brand/
    dreal-mark.svg         The DREAL mark, vector. USE THIS ONE where you can.
    dreal-mark-black.png   1984x2048, transparent. For light backgrounds.
    dreal-mark-white.png   1984x2048, transparent. For dark backgrounds.
    dreal-app-icon.png     1024x1024. The app icon as the stores show it.

The ready-made blocks
---------------------

Open snippets/<your language>.html in a browser. Everything is plain HTML with
the styling written onto the elements, so it will not fight your own stylesheet,
and there is no script and nothing to install.

The pictures and films load from our servers, so there is nothing for you to
upload and nothing to keep up to date. If you would rather host them yourself,
the same files are in this kit under film/ and photography/ — change the
addresses in the block to your own.

If your website builder will not let you paste HTML, use the embed block
instead. It is a single line and we keep what is inside it current.

Every block shows all four sites, and please keep it that way
-------------------------------------------------------------

DREAL Museums is ONE pass that opens every chapter at every site. There is no
per-site purchase and no per-site price.

So a block that shows only one site tells your traveller they are buying that
site, and they are not. That is why every ready-made block below shows the four
together, at the same size and in the same order — the four equal frames are
what says "all of these" before a word is read.

If you are writing your own page around the photographs in this kit rather than
using a block, the same thing applies: name the four, or name none.


Two things about the blocks that are deliberate, not oversights:

  - The films in them are SILENT. Every browser refuses to autoplay a video
    with sound, and it refuses quietly — a block that asked for sound would
    simply not play at all. The films do have sound; it is in the app.
  - There is no price anywhere. Prices differ by country and change, and the
    stores show each traveller the price that applies to them. Please do not
    add one.


The films are the strongest thing in this kit
---------------------------------------------

If you put one asset on your page, put a film on it. They are portrait, six
seconds, and small enough to autoplay — and they show the product doing the one
thing a photograph cannot show it doing.

They carry sound. Start them muted (browsers will refuse to autoplay otherwise)
and let a visitor turn the sound on if you have somewhere to put that control.

One button, and it goes to our website
--------------------------------------

Every block carries a single call to action, and it opens dreal.co in the
reader's own language. The whole card is a link as well, so a click anywhere on
it does the same thing.

There are deliberately NO App Store or Google Play buttons in these blocks. A
traveller sent straight to a store arrives at a price with no idea what they are
buying; our site explains the product first, in all eleven languages, and puts
the store buttons at the end of that. One button is also one decision, on a page
that is already asking them to book a tour.

The button opens our site in a NEW TAB, so a reader who clicks it does not lose
your page — they still have your tour open behind it.

If you need the store links themselves, they are in store/links.txt.

Using the mark
--------------

  - Black or white only. Please do not recolour it, add a gradient, or apply
    effects.
  - Do not stretch it. It is 992:1024 — very slightly taller than square, and
    forcing it into a square box is the commonest way it goes wrong.
  - Keep clear space around it of at least 25% of its height.
  - Do not use it below 24px tall, where the counter inside the D closes up.
  - Do not put the white mark on a light background, or the black on a dark one.
  - Do not enclose it in a shape, or combine it with your own mark into a lockup.
    Place the two marks side by side with space between them instead.

Writing the name
----------------

DREAL has no fixed logotype, so there is no wordmark file in this kit and no
typeface to match. Set "DREAL Museums" in your own body or heading font.

Write it as two words with DREAL in capitals — DREAL Museums — and use the full
name on first mention. It is fine to shorten it to DREAL after that. Please do
not write it Dreal, DreaL or D-Real.

⚠️ The photograph is built for a DARK background
-------------------------------------------------

photography/hero.jpg has the phone standing proud of the bottom of the picture.
In the original that area is transparent; a JPEG cannot hold transparency, so it
is filled with the near-black our own cards use. On a dark page it is invisible,
which is the point. On a WHITE page you would see a dark band under the phone.

So: use it on a dark background, or use one of the ready-made blocks, which
already carry the right one. If you need it on a light page, write to us and we
will send a version cut for that.


Photographs
-----------

The photographs may be cropped to fit your layout.

⚠️ Do not put words INTO the artwork. The app runs in 11 languages
and never asks which one, so text baked into a picture cannot be translated. Set
your words in HTML beside the image instead.


Two things to get right
-----------------------

  1. DREAL Museums works AT the sites, and needs a connection there. It is not
     an offline app and not a museum guide to read on the plane. Saying so on
     your page prevents the one complaint that comes back.

  2. Do not state a price. Prices differ by country and change; the App Store
     and Google Play show each traveller the price that applies to them.

Localized product copy
----------------------

The site and chapter text in copy/ is authored in all 11 languages.
The product paragraphs in about.md are English only — for the other languages,
https://dreal.co is published in each of them and you are welcome to quote its wording
directly. Or write to us and we will send it.

Credit
------

Where you have room for a technical credit, the AR is built on Snap Camera Kit:

  AR powered by Snap Camera Kit

Contact
-------

  Partners   support@dreal.co
  Website    https://dreal.co
