https://github.com/block-foundation/brand
Official brand assets of the Block Foundation
https://github.com/block-foundation/brand
architecture block-foundation blockchain blockfoundation brand real-estate style styleguide
Last synced: 5 months ago
JSON representation
Official brand assets of the Block Foundation
- Host: GitHub
- URL: https://github.com/block-foundation/brand
- Owner: block-foundation
- License: cc-by-sa-4.0
- Created: 2023-07-19T19:54:48.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-18T05:11:56.000Z (almost 2 years ago)
- Last Synced: 2025-09-05T14:17:24.285Z (9 months ago)
- Topics: architecture, block-foundation, blockchain, blockfoundation, brand, real-estate, style, styleguide
- Language: HTML
- Homepage: https://www.blockfoundation.io
- Size: 28.8 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
- Governance: .github/GOVERNANCE.md
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
---
Block Foundation
Brand Assets & Visual Identity Guide
---
### Contents
- [Style Guide](#style-guide)
- [Logo](#logo)
- [Typography](#typography)
- [Color](#color)
- [Graphics](#graphics)
- [Diagrams](#diagrams)
- [Elements](#elements)
- [Frameworks](#frameworks)
- [Templates](#templates)
- [Syntax](#syntax)
- [Colophon](#colophon)
---
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=bug_report.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=feature_request.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=question.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=suggestion.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=discussion.yml)
**Welcome to the official Brand Repository of the Block Foundation – Let's together uphold and amplify the voice of change in the world of architecture!**
## Introduction
This repository is an all-inclusive resource of our brand identity, encapsulating our ethos, vision, and the graphical elements that distinguish us in the global arena of architectural innovation.
Our brand is not just a logo or a name, but a reflection of our mission to revolutionize architecture through blockchain technology. It symbolizes our commitment to facilitating a sustainable, equitable, and dynamic housing market that balances the interests of all stakeholders.
This repository hosts a comprehensive collection of our branding materials — from our logo in various formats to color palettes, typography guidelines, official stationary templates, and presentation layouts. Each element is meticulously designed to communicate our essence, ensuring a cohesive and consistent representation of the Block Foundation across all platforms.
We invite our community, collaborators, and media personnel to use this repository as a guide when representing the Block Foundation. Whether you're creating content for us, collaborating on a project, or featuring our work, these resources will ensure you accurately capture and convey the spirit of our organization.
We kindly ask that you adhere to the guidelines detailed in this repository to maintain the integrity of our brand. And remember, our brand is not just an identifier but a promise of the transformative potential blockchain holds for the architectural landscape.
## Style Guide
`Will be provided shortly.`
## Logo
[(Back to top)](#block-foundation)
### Logomark
| Variant | PNG | SVG | WEBP | JPG |
| :---------- | ----- | ----- | ----- | ----- |
| **dark** | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark.webp) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark.jpg) |
| **dark transparant** | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark-trans.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark-trans.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_dark-trans.webp) | |
| **gray** | [](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray.webp) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray.jpg) |
| **gray transparant** | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray-trans.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray-trans.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray-trans.webp) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_gray-trans.jpg) |
| **light** | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light.webp) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light.jpg) |
| **light transparant** | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light-trans.png) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light-trans.svg) | [
](https://github.com/block-foundation/brand/blob/master/src/logo/logo_light-trans.webp) | |
### Logotype
`Will be provided shortly.`
### Favicon
### Badge
Share that your organisation or project endorses the Block Foundation by adding our badge to your readme or website.
`Will be provided shortly.`
### ASCII Art
``` txt
# .............................................................................
# .............................................................................
# ....................................@@@......................................
# ................................@@@@@@@@@@@..................................
# ............................@@@@@@..@@@..@@@@@@..............................
# ........................@@@@@@......@@@......@@@@@@..........................
# ...................@@@@@@...........@@@..........,@@@@@@.....................
# ...............@@@@@@...............@@@...............@@@@@@.................
# ...........@@@@@@...................@@@...................@@@@@@.............
# .........@@@@@@.....................@@@.....................@@@@@@...........
# .........@@@.@@@@@@.................@@@.................@@@@@@.@@@...........
# .........@@@.....@@@@@@.............@@@.............@@@@@@.....@@@...........
# .........@@@.........@@@@@@@........@@@........@@@@@@@.........@@@...........
# .........@@@..............@@@@@@....@@@....@@@@@@..............@@@...........
# .........@@@..................@@@@@@@@@@@@@@@..................@@@...........
# .........@@@......................@@@@@@@......................@@@...........
# .........@@@........................@@@........................@@@...........
# .........@@@........................@@@........................@@@...........
# .........@@@........................@@@........................@@@...........
# .........@@@........................@@@........................@@@...........
# .........@@@........................@@@........................@@@...........
# .........@@@@.......................@@@.......................@@@@...........
# ...........@@@@@@...................@@@...................@@@@@@.............
# ...............@@@@@@...............@@@...............@@@@@@.................
# ...................@@@@@@...........@@@...........@@@@@@.....................
# ........................@@@@@@......@@@......@@@@@@..........................
# ............................@@@@@@..@@@..@@@@@@..............................
# ................................@@@@@@@@@@@..................................
# ....................................@@@......................................
# .............................................................................
# .............................................................................
```
``` txt
........................................................................
..................@................. .
...............@@@@@@@.............. BLOCK FOUNDATION .
...........@@@....@....@@@.......... .
.......@@@........@........@@@...... www.blockfoundation.io .
......@@@@........@........@@@@..... info@blockfoundation.io .
......@.....@@@...@...@@@.....@..... .
......@.........@@@@@.........@..... .
......@...........@...........@..... .
......@...........@...........@..... .
......@...........@...........@..... .
.........@@@......@......@@@........ .
.............@@@..@..@@@............ .
..................@................. .
........................................................................
```
## Typography
### Main Display Font
We us `Barlow`.
- Creators: [Jeremy Tribby](https://github.com/jpt) (Principal Design) and [Nguyễn Hồng Nhung](https://github.com/crystaltype) (Vietnamese)
- Repository: [jpt/barlow](https://github.com/jpt/barlow)
- License: [OFL](https://github.com/jpt/barlow/blob/main/OFL.txt)
- GIF courtesy of the original creators.
### Secondary Font
`Will be provided shortly.`
### Text Conventions
#### Brand Name
Capitalize the "B" and "F" in "Block Foundation" in all copy text. The Block Foundation should only be presented in all uppercase when displayed in our official logos; e.g.: "BLOCK FOUNDATION". In code, "block_foundation" is all lowercase / snakecase.
- ✓ BLOCK FOUNDATION `(in Logo)`
- ✓ Block Foundation `(in Text)`
- ✓ block_foundation `(in Code)`
- × BlockFoundation
- × blockFoundation
- × Block-Foundation
- × block-foundation
- × block foundation
#### Headers
All headers are written in Title Case.
#### Emoji's
We don't use them, ever.
## Color
### Base Colors
| | Color | HEX | RGB | HSL | HSB | CMYK |
| --------- | --------- | --------- | --------- | --------- | --------- | --------- |
| 
| **Base 01** | `#041B26` | `4, 27, 38` | `199, 81%, 8%` | `200, 90, 15` | `13%, 4%, 0%, 85%` |
| 
| **Base 02** | `#E1E4E5` | `225, 228, 229` | `195, 7%, 89%` | `200, 2, 90` | `2%, 0%, 0%, 10%` |
| 
| **Base 03** | `#F0F1F2` | `240, 241, 242` | `210, 7%, 95%` | `200, 1, 95` | `1%, 0%, 0%, 5%` |
| 
| **Base 04** | `#FFFFFF` | `255, 255, 255` | `0, 0%, 100%` | `0, 0, 0` | `0%, 0%, 0%, 0%` |
### Secondary Colors
`Will be provided shortly.`
## Graphics
### Artworks
Our repositories use the following artworks to make them just a little bit moe enticing!
| Color | Monochrome | Acccent |
| ----- | ---------- | ------- |
| [
](https://github.com/block-foundation/brand/master/src/image/repository_cover/block_foundation-structure-03-color.jpg)*`structure-03-color`* | [
](https://github.com/block-foundation/brand/master/src/image/repository_cover/block_foundation-structure-03-mono.jpg)*`structure-03-mono`* | [](https://github.com/block-foundation/brand/master/src/image/repository_cover/block_foundation-structure-03-accent.jpg)*`structure-03-accent`* |
### Photography
`Will be provided shortly.`
### Banners
`Will be provided shortly.`
## Diagrams
We use [Mermaid](https://mermaid.js.org/) in our repositories for simple data and process visualisations. Some examples:
### Flowchart
``` mermaid
flowchart LR
Light:::class_light --> Neutral:::class_neutral --> Dark:::class_dark
classDef class_light fill:#FFFFFF,color:#041B26,stroke:#041B26,stroke-width:2px;
classDef class_neutral fill:#E1E4E5,color:#041B26,stroke:#041B26,stroke-width:2px;
classDef class_dark fill:#041B26,color:#FFFFFF,stroke:#041B26,stroke-width:2px;
```
`class_light`
``` md
classDef class_light fill:#FFFFFF,color:#041B26,stroke:#041B26,stroke-width:2px;
```
`class_neutral`
``` md
classDef class_neutral fill:#E1E4E5,color:#041B26,stroke:#041B26,stroke-width:2px;
```
`class_dark`
``` md
classDef class_dark fill:#041B26,color:#FFFFFF,stroke:#041B26,stroke-width:2px;
```
### Pie chart
``` mermaid
%%{init: {"theme": "base", "pie": {"textPosition": 0.5}, "themeVariables": { "pieOuterStrokeWidth": "2px", "pie1": "#FFFFFF", "pie2": "#E1E4E5", "pie3": "#041B26"}}}%%
pie title Crypto
"Bitcoin" : 386
"Ethereum" : 85
"Algorand" : 15
```
``` md
%%{init: {"theme": "base", "pie": {"textPosition": 0.5}, "themeVariables": { "pieOuterStrokeWidth": "2px", "pie1": "#FFFFFF", "pie2": "#E1E4E5", "pie3": "#041B26"}}}%%
```
## Elements
### Icons
Within our repositories we use simple-icons for most iconographic purposes. This brand repository includes a copy this icon set (downloaded per 2023-07-25): [/src/icons/simple-icons/](/src/icons/simple-icons/)
- simple-icons website: [simpleicons.org](https://simpleicons.org/)
- simple-icons reposiory: [github.com/simple-icons/simple-icons](https://github.com/simple-icons/simple-icons)
- simple-icons license: [CC0 1.0 Universal](https://github.com/simple-icons/simple-icons/blob/develop/LICENSE.md)
### IO Shields
We use [IO Shields](https://shields.io/) combined with [simple-icons](https://simpleicons.org/) to display repository information.
#### Parameters
| Field | Value | Description |
| :-------------- | :-------------- | :---------- |
| style | `flat-square` | |
| logo | `bitcoin` | Named logo via [simple-icons](https://simpleicons.org/) |
| logoColor | `#FFFFFF` | All white logo to match the text color |
| label | `License:` | Title caps label text |
| labelColor | `#041B26` | Completely dark background |
| color | `#041B26` | |
| cacheSeconds | default | |
| link | misc. | Always try to provide a link |
#### Shields
| | | shield.io url | simpleicons tag |
| :-------------------- | :---- | :---- | :---- |
| **License** | [](https://github.com/block-foundation/brand/blob/main/LICENSE) | [/badges/git-hub](https://shields.io/badges/git-hub) | `readthedocs` |
| **Docker Pulls** | [](https://hub.docker.com/r/blockfoundation/ethereum-client) | `docker` |
| **Docker Stars** | [](https://hub.docker.com/r/blockfoundation/ethereum-client) | [/badges/docker-stars](https://shields.io/badges/docker-stars) | `docker` |
| **Docker Version** | [](https://hub.docker.com/r/blockfoundation/ethereum-client/tags) | [/badges/docker-stars](https://shields.io/badges/docker-stars) | `docker` |
| **Docker Size** | [](https://hub.docker.com/r/blockfoundation/ethereum-client) | [/badges/docker-image-size-tag](https://shields.io/badges/docker-image-size-tag) | `docker` |
| **devContainer** | [](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand) | [/badges](https://shields.io/badges) | `visualstudiocode` |
| **DOI** | [](https://doi.org/10.5281/zenodo.8173471) | [/badges](https://shields.io/badges) | `DOI` |
| **Zotero** | [](https://www.zotero.org/groups/block) | [/badges](https://shields.io/badges) | `Zotero` |
| **Download** |  | [/badges](https://shields.io/badges) | `files` |
| **Solidity** |  | [/badges](https://shields.io/badges) | `Solidity` |
| **Teal** |  | [/badges](https://shields.io/badges) | `Algorand` |
| **Substrate** |  | [/badges](https://shields.io/badges) | `paritysubstrate` |
| **Hyperledger** |  | [/badges](https://shields.io/badges) | `Hyperledger` |
#### Repository Headers
All repositories include the basic header, in some cases combined with additional shields.
##### Basic Repository Header
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
##### Basic Repository Interactions
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=bug_report.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=feature_request.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=question.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=suggestion.yml)
[](https://github.com/block-foundation/brand/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&projects=&template=discussion.yml)
##### Docker Container Repository Header
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
[](https://hub.docker.com/r/blockfoundation/ethereum-client)
[](https://hub.docker.com/r/blockfoundation/ethereum-client)
[](https://hub.docker.com/r/blockfoundation/ethereum-client/tags)
[](https://hub.docker.com/r/blockfoundation/ethereum-client)
##### LaTeX / Citation Repository Header
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
[](https://doi.org/10.5281/zenodo.8173471)
[](https://www.zotero.org/groups/block)
##### TypeScript / NPM Repository Header
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
##### Python / PyPi Repository Header
[](https://github.com/block-foundation/brand/blob/main/LICENSE)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/block-foundation/brand)
## Frameworks
### SCSS
We use the [Stylescape SCSS Framework](https://github.com/scape-agency/stylescape) developed by [Scape Agency](https://www.scape.agency)® for all our online content.
- Website: [scape.style](https://www.scape.style)
- Repository: [github.com/scape-agency/stylescape](https://github.com/scape-agency/stylescape)
#### HTML Script Tag
``` html
```
#### NPM Module
``` bash
npm i stylescape
```
## Templates
### Presentation Template
`Will be provided shortly.`
#### Contents
- PDF
- Keynote
- PowerPoint
#### Customize
1. Requires Keynote to edit
2. Install the fonts here
3. Replace the for-placement-only images by dragging new images onto them
4. Fill out your name, Twitter, and other details as you see fit.
5. Create new slides to fit your talk
### Figma Template
For those who use [Figma](www.figma.com), we have included a template that can be used to create a new project. This template has Color Presets and some of the most common components.
Duplicate the template and rename it to your project name.
`Will be provided shortly.`
### HTML Email Signature Templates
Always in plain simple `text`.
``` txt
□ BLOCK FOUNDATION
Lars van Vianen
lars@blockfoundation.io
www.blockfoundation.io
info@blockfoundation.io
```
`Will be provided shortly.`
## Syntax
### General
Superseding Conventions:
- We use `4 spaces` for indents
- We use a maximum line length of `79 characters` in all languages (as per [PEP8](https://peps.python.org/pep-0008/#maximum-line-length))
- Strings should be quoted with double-quotes instead of single-quotes.
- Surround operators with a single space on either side.
### Style Guides
| Language | Convention |
| :------------------ | :--------- |
| `Go` | [Google Go Style Guide](https://github.com/google/styleguide/tree/gh-pages/go) |
| `Go` | [Uber Go Style Guide](https://github.com/uber-go/guide) |
| `JavaScript` | [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript) |
| `JavaScript` | [Google JavaScript Style Guide](https://google.github.io/styleguide/jsguide.html) |
| `Python` | [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html) |
| `Solidity` | [Solidity Style Guide](https://docs.soliditylang.org/en/latest/style-guide.html)
| `TypeScript` | [Google TypeScript Style Guide](https://google.github.io/styleguide/tsguide.html) |
---
## Colophon
### Development Resources
#### Version
This documentation is in version `v0.0.1`.
Last edited: `07/2023`
#### Authors
This is an open-source project by the **[Block Foundation](https://www.blockfoundation.io "Block Foundation website")**.
The Block Foundation mission is enabling architects to take back initiative and contribute in solving the mismatch in housing through blockchain technology. Therefore the Block Foundation seeks to unschackle the traditional constraints and construct middle ground between rent and the rigidity of traditional mortgages.
website: [www.blockfoundation.io](https://www.blockfoundation.io "Block Foundation website")
#### Contributing
We'd love for you to contribute and to make this project even better than it is today!
Please refer to the [contribution guidelines](.github/CONTRIBUTING.md) for information.
### Legal Information
#### Copyright
Copyright © 2023 [Stichting Block Foundation](https://www.blockfoundation.io/ "Block Foundation website"). All Rights Reserved.
#### License
Except as otherwise noted, the content in this repository is licensed under the
[Creative Commons Attribution 4.0 International (CC BY 4.0) License](https://creativecommons.org/licenses/by/4.0/), and
code samples are licensed under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).
Also see [LICENSE](https://github.com/block-foundation/community/blob/master/src/LICENSE) and [LICENSE-CODE](https://github.com/block-foundation/community/blob/master/src/LICENSE-CODE).
#### Disclaimer
**THIS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**