Add a README.md file

Signed-off-by: Michael Tremer <michael.tremer@ipfire.org>

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..01009e6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+# IPFire Artwork
+
+This repository contains the official artwork and brand assets for the [IPFire](https://www.ipfire.org) project, including logos and favicons in all supported formats and colour variants.
+
+Pre-rendered versions of all assets are available at **[artwork.ipfire.org](https://artwork.ipfire.org)**.
+
+## Assets
+
+The following assets are included:
+
+- **Logo** — the full IPFire wordmark
+- **Favicon** — a compact square icon suitable for use in browsers, apps, and other small contexts
+
+## Colour Variants
+
+Each asset is rendered in three colour variants:
+
+| Variant | Description |
+|---|---|
+| `standard` | Full colour, for use on white or light backgrounds |
+| `monochrome` | Single dark colour, for print or single-colour contexts |
+| `inverted` | White, for use on dark or coloured backgrounds |
+
+## File Formats
+
+Each variant is available in the following formats:
+
+| Format | Sizes |
+|---|---|
+| SVG | — |
+| PDF | — |
+| PNG (logo) | 512, 1024, 2048, 4096 |
+| PNG (favicon) | 32×32, 64×64, 128×128, 256×256, 512×512 |
+
+## Building
+
+Rendering the assets from source requires [Inkscape](https://inkscape.org) to be installed.
+
+```sh
+make all
+```
+
+To remove all rendered files:
+
+```sh
+make clean
+```
+
+## Colours
+
+| Name | Hex |
+|---|---|
+| Primary | `#ff2e52` |
+| Dark | `#363636` |
+| White | `#ffffff` |
+
+## Font
+
+The logo uses [Prompt Bold](https://fonts.google.com/specimen/Prompt) by Cadson Demak.
+
+## License
+
+The IPFire logo and all associated artwork are the property of the IPFire Project and may not be used without permission.
+