diff --git a/README.md b/README.md
index 8b63a9c2..a1e17bef 100644
--- a/README.md
+++ b/README.md
@@ -286,22 +286,68 @@ Check out the [news](doc/news.md) page to keep track of babashka-related news it
Go [here](https://book.babashka.org/#built-in-namespaces) to see the full list of built-in namespaces.
-## [Projects](doc/projects.md)
+## [Compatible Projects](doc/projects.md)
A list of projects (scripts, libraries, pods and tools) known to work with babashka.
-### Flair
-
-Do you have a library that runs with babashka? Add this badge to add some flair
-to your repo:
+## Badges
+
[](https://babashka.org)
-The raw HTML:
+The babashka compatible badge indicates that a [library can be used as babashka dependency](doc/projects.md).
-``` html
+If this is the case for your library, we encourage you to proudly display this badge.
+
+Markdown
+
+```markdown
+[](https://babashka.org)
+```
+
+
+AsciiDoc
+
+```asciidoc
+https://babashka.org[image:https://raw.githubusercontent.com/babashka/babashka/master/logo/badge.svg[bb compatible]]
+```
+
+
+HTML
+
+```html
```
+
+
+
+[](https://babashka.org)
+
+The babashka built-in badge means that a [library has been built directly into babashka](https://book.babashka.org/#built-in-namespaces) and requires no extra dependencies to use it.
+
+If this rare honor belongs to your library, you should display this badge.
+
+Markdown
+
+```markdown
+[](https://babashka.org)
+```
+
+
+AsciiDoc
+
+```asciidoc
+https://babashka.org[image:https://raw.githubusercontent.com/babashka/babashka/master/logo/built-in-badge.svg[bb built-in]]
+```
+
+
+HTML
+
+```html
+
+```
+
+
## [Pods](https://github.com/babashka/babashka.pods)
diff --git a/logo/built-in-badge.svg b/logo/built-in-badge.svg
new file mode 100644
index 00000000..afeae2eb
--- /dev/null
+++ b/logo/built-in-badge.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
```
+
+```
+