diff --git a/docs/overview/logos.md b/docs/overview/logos.md
new file mode 100644
index 0000000000..39071ed793
--- /dev/null
+++ b/docs/overview/logos.md
@@ -0,0 +1,41 @@
+---
+id: logos
+title: Logos
+sidebar_label: Logo assets
+---
+
+Guidelines for how to use the Backstage logo and icon can be found
+[here](/logo_assets/Backstage_Identity_Assets_Overview.pdf). The assets below
+are all in `.svg` format. Other formats are available in the
+[repository](https://github.com/spotify/backstage/tree/master/microsite/static/logo_assets).
+
+## Backstage logo
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Backstage icon
+
+
diff --git a/docs/verify-links.js b/docs/verify-links.js
index a218cde71b..9bf8a67ad8 100755
--- a/docs/verify-links.js
+++ b/docs/verify-links.js
@@ -53,6 +53,11 @@ async function verifyUrl(basePath, url) {
return { url, basePath, problem: 'not-relative' };
}
+ const staticPath = resolvePath(projectRoot, 'microsite/static', `.${url}`);
+ if (await fs.pathExists(staticPath)) {
+ return;
+ }
+
path = resolvePath(projectRoot, `.${url}`);
} else {
path = resolvePath(dirname(resolvePath(projectRoot, basePath)), url);
@@ -103,7 +108,9 @@ async function main() {
console.log(`Found ${badUrls.length} bad links within repo`);
for (const { url, basePath, problem } of badUrls) {
if (problem === 'missing') {
- console.error(`Unable to reach ${url}, linked from ${basePath}`);
+ console.error(
+ `Unable to reach ${url} from root or microsite/static/, linked from ${basePath}`,
+ );
} else if (problem === 'not-relative') {
console.error('Links to /docs/ must be relative');
console.error(` From: ${basePath}`);
diff --git a/microsite/sidebars.json b/microsite/sidebars.json
index 3e69ad00f4..a3c11beeac 100644
--- a/microsite/sidebars.json
+++ b/microsite/sidebars.json
@@ -7,7 +7,8 @@
"overview/roadmap",
"overview/vision",
"overview/background",
- "overview/adopting"
+ "overview/adopting",
+ "overview/logos"
],
"Getting Started": [
"getting-started/index",
diff --git a/microsite/static/logo_assets/Backstage_Identity_Assets_Overview.pdf b/microsite/static/logo_assets/Backstage_Identity_Assets_Overview.pdf
new file mode 100644
index 0000000000..ad091c18e2
Binary files /dev/null and b/microsite/static/logo_assets/Backstage_Identity_Assets_Overview.pdf differ
diff --git a/microsite/static/logo_assets/ai/Backstage Identity_Assets_Artwork_RGB.ai b/microsite/static/logo_assets/ai/Backstage Identity_Assets_Artwork_RGB.ai
new file mode 100644
index 0000000000..f849131417
--- /dev/null
+++ b/microsite/static/logo_assets/ai/Backstage Identity_Assets_Artwork_RGB.ai
@@ -0,0 +1,2999 @@
+%PDF-1.5
%
+1 0 obj
<>/OCGs[11 0 R 46 0 R 80 0 R]>>/Pages 3 0 R/Type/Catalog>>
endobj
2 0 obj
<>stream
+
+
+
+
+ application/pdf
+
+
+ Backstage Identity_Assets_Artwork_RGB
+
+
+ 2020-04-28T11:21:44+01:00
+ 2020-04-28T11:21:44+01:00
+ 2020-04-27T17:08:19+01:00
+ Adobe Illustrator CC 23.1 (Macintosh)
+
+
+
+ 256
+ 108
+ JPEG
+ /9j/4AAQSkZJRgABAgEASABIAAD/7QAsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA
AQBIAAAAAQAB/+4ADkFkb2JlAGTAAAAAAf/bAIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoK
DBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxscHx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8f
Hx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f/8AAEQgAbAEAAwER
AAIRAQMRAf/EAaIAAAAHAQEBAQEAAAAAAAAAAAQFAwIGAQAHCAkKCwEAAgIDAQEBAQEAAAAAAAAA
AQACAwQFBgcICQoLEAACAQMDAgQCBgcDBAIGAnMBAgMRBAAFIRIxQVEGE2EicYEUMpGhBxWxQiPB
UtHhMxZi8CRygvElQzRTkqKyY3PCNUQnk6OzNhdUZHTD0uIIJoMJChgZhJRFRqS0VtNVKBry4/PE
1OT0ZXWFlaW1xdXl9WZ2hpamtsbW5vY3R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo+Ck5SVlpeYmZ
qbnJ2en5KjpKWmp6ipqqusra6voRAAICAQIDBQUEBQYECAMDbQEAAhEDBCESMUEFURNhIgZxgZEy
obHwFMHR4SNCFVJicvEzJDRDghaSUyWiY7LCB3PSNeJEgxdUkwgJChgZJjZFGidkdFU38qOzwygp
0+PzhJSktMTU5PRldYWVpbXF1eX1RlZmdoaWprbG1ub2R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo
+DlJWWl5iZmpucnZ6fkqOkpaanqKmqq6ytrq+v/aAAwDAQACEQMRAD8A9U4q7FXYq7FXYq7FXYq7
FXYq7FXYq7FULqd99TtTNx5EkKvgCe5yUY2XF1mp8GHEk0N7xvoRDIJmklQS3ALLzD1HFkO23bLD
HZ0+PU1ljwniuQuW4u+hHkmN5qNxDNMqAFYgrU9N2ry61cHiv05ARBdjqNXOEpAco1/CT9vIfFVb
VoBM8XBiy1C04ksQwWlK1FSwpXBwNh10RIxo7e7vA7/Pq46lxuEieNkaQUWMgci1ada8aU3x4dlO
rqYiQRfTrf3UtXVVkYLHExPNUYErUBq9RyqDt3w8CBrhI0AeYHT9baavC5KpGxckKigqSS1ffb7J
rXHgWOvjLYA38PPz8urhrFsZETi4ZqAg8aqSxUVFfEdseAqNfAkCjv7tt67/ALkdkHOdirsVdirG
/wAxvOcXkvyVqnmaS2a8GnohW2Vghd5ZUhQFj0XlICx8MVfM+ofmjKms22t6TqsOueYrx7W8n1qE
3dk1pE08UUmlNaSFoprernj06lvtipVe4/mL+YXmXQfMM2naUIzFBpP6TCfoq/1SSWX1ZI/TLWc0
S26UQfHIKYq4/nr5btrqG1v7aVZHszcvLbSW86l0sf0g6RxrL67IYgQkhjCs2wOKq+sfm02j6lpk
Gr6Nd6WL5p7dbK4WF7ie5rbC1S2lima2YSfWSG5P8JG5WlSqp6j+c9sl1qdhYaPdTahplxHBJBJJ
aIxU3sdm7mI3CyorNL+6Zlo+xrSuKqj/AJ2eX01a+0o2F215as0VtCj2jyXEy3kNh6QjWctEzT3K
cPW41X4umKqOofnv5Z02Vbe/0++tr2N5lvrR/qvqQLbyCJ32nIlBY/CIuTMATToCq9KxV2KuxV2K
uxV2KuxV2KuxV2KuxV2KqF7Zw3kBhlrxJqCDQgjvhjKmjUaeOWPDJCabocFnI0hb1mNOBKgcad++
+SlO3E0nZscJJviPu5IuWxtpXZ3ViXADgO4DAdAVBAOREi5c9NCRJN7+Z+61h0yyJJKHetBzag5H
kaCu2++2HiLA6LH3faeu/wAN91w0+0404E16sWYtWvKta1rXvjxFl+Vx1y+0+9pdOtFNQrV2oebV
HE1AG+wx4igaTGOn2nopyaTBwAhJjZacSWdgAvQD4gR9BGHja5aGNenY+8nl8dvgQvh023jSMblk
pvVgDQlhUV3oT3wGRZ49HCIHl7/f+LRWRcp2KuxV2KpR5s8raP5r8vXvl/WY2l06+VVmVHMbAo6y
IysvQq6Kw7bb1GKvMfy5/wCcZfLPk7zLNrM98dajCcLGzureMLCRIsiyO1XEkiMg4sFWnhXFXo2u
+RPLeuX/ANf1CO6F2bf6m8lrfXtnzt+Rf0pFtZoVdeTn7QOKpW/5Pfl68lTpri3qxWyW6ultVL2p
s3K26yCIc7c8Gou4xVEr+V/kn6vPDNYPdfWUliuZrq5uriaRZ0ijcPNNK8hotvGEPKqcfhpiqxvy
r8lO8zyWtxIZldBzvr1vSEs6XMhtyZqws80KOWjINRiqX61+Tnli8tbkae09lfyh/q88tzeXMMJl
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
q7FX/9k=
+
+
+
+ uuid:a094fc3f-430f-7744-b388-fdb7ec44f815
+ xmp.did:17c4aec8-eddf-4473-bdc7-9dbc4289c51b
+ uuid:5D20892493BFDB11914A8590D31508C8
+ proof:pdf
+
+ xmp.iid:c8804a9b-d36f-42ac-b594-d814edaf8ca1
+ xmp.did:c8804a9b-d36f-42ac-b594-d814edaf8ca1
+ uuid:5D20892493BFDB11914A8590D31508C8
+ proof:pdf
+
+
+
+
+ saved
+ xmp.iid:96cc7365-26ab-46ae-a826-605707e77cc1
+ 2020-04-20T16:59:06+01:00
+ Adobe Illustrator CC 23.1 (Macintosh)
+ /
+
+
+ saved
+ xmp.iid:17c4aec8-eddf-4473-bdc7-9dbc4289c51b
+ 2020-04-27T17:08:17+01:00
+ Adobe Illustrator CC 23.1 (Macintosh)
+ /
+
+
+
+ Print
+ Document
+ Adobe PDF library 15.00
+ 1
+ False
+ False
+
+ 346.562312
+ 440.050339
+ Millimeters
+
+
+
+ Cyan
+ Magenta
+ Yellow
+ Black
+
+
+
+
+
+ Default Swatch Group
+ 0
+
+
+
+ White
+ RGB
+ PROCESS
+ 255
+ 255
+ 255
+
+
+
+
+
+ Backstage RGB
+ 1
+
+
+
+ Teal 01
+ PROCESS
+ 100.000000
+ RGB
+ 53
+ 185
+ 162
+
+
+ Teal 02
+ PROCESS
+ 100.000000
+ RGB
+ 125
+ 242
+ 224
+
+
+ Magenta
+ PROCESS
+ 100.000000
+ RGB
+ 240
+ 55
+ 165
+
+
+ Blue
+ PROCESS
+ 100.000000
+ RGB
+ 46
+ 119
+ 208
+
+
+ Grey
+ PROCESS
+ 100.000000
+ RGB
+ 64
+ 64
+ 64
+
+
+ Black
+ PROCESS
+ 100.000000
+ RGB
+ 18
+ 18
+ 18
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
endstream
endobj
3 0 obj
<>
endobj
5 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 2079.95 456.054]/Type/Page>>
endobj
6 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 337.465 428.499]/Type/Page>>
endobj
7 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 2079.95 456.054]/Type/Page>>
endobj
8 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 337.465 428.499]/Type/Page>>
endobj
9 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 2079.95 456.054]/Type/Page>>
endobj
10 0 obj
<>/Resources<>/ExtGState<>/Properties<>>>/TrimBox[0.0 0.0 337.465 428.499]/Type/Page>>
endobj
13 0 obj
<>/Resources<>/ExtGState<>/Properties<>/Shading<>>>/TrimBox[0.0 0.0 982.381 1247.39]/Type/Page>>
endobj
91 0 obj
<>stream
+Hd6y
+dFpO.`%Ͱf"}ϗնJs+T-mWؼݼ=Gc)נ_=Y
+Vx{ߊǴVԮ뉼_f\Oēl+m^ɧ{x"Wy/7kqs>sƺ[,[
mDyhbWbi?ne.Ǧm|{ Vae#{6ֹv@a:cC>_'Br
+i2lb{ʄx WʎVR+#Myfڬ|yoi{pv
+)6≼A]gN:57gS+g aI>"dðu3^aG5rDam9QVP;c Wv_34~-dak=u2FjQBg,0ȹ"1QoA{KH̸!֍qT(6FBDB n@(k@-N:
={L1DHZH{X|!y#J@6}q~du{n7:xE1| ְ=4j
+⅔@ *5Q fbJQUP\k?dqk![#5L%Aa$l~6TDCkq,
+#d@I]E2$-|"+@.c=EHZ%IFU6LazE%AC4N@0I癌ewSȸȌ6'ŨULqwF7I;p~x b4bHZu5R5v'BعȊrἫ Fyv5EqqDJNDU "j&&0ZyO) 9
ᜨ;)Ea^]d{Yhx5!%rx47D:V'ht9ZKj,.M~k5X
CfIAS=z4m=W&U))S!oSI5ym<6o,ܑߨ:]dj#T]ijtj7{6 )fѢ
+Gk$ue(-뎼/51~$u4Z4v#*ÚYaC
+fEPHq"
$7!BJ?pnUtnEwxwVB*7ZXj7L<+at~%#?W]ʹeW7Mq3ej?fNے+mD3=az1-ODqD"?](;K&*Ʌ\T-DLxz>Ei4`7M%I]
+CJY e7I.䒤3RzKr%LM&Ʌ\tF&]d=%);Vn\%Io8KS֛$!