diff --git a/README.md b/README.md
index e2b8352..e00d771 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,53 @@
+# Warp Themes
+
+This is an open source repository with themes for [Warp](https://www.warp.dev/).
+We welcome and appreciate any contributions!
+
+We have [directions on how to use this repository in our documentation.](https://docs.warp.dev/features/themes)
+
+[Discord](https://discord.gg/warpdotdev)
+
+[Warp Repo](https://github.com/warpdotdev/Warp)
+
+## Open source dependencies
+
+We'd like to call out a few of the open source themes and repositories that helped bootstrap the set of themes for Warp:
+
+- [iTerm colors pencil](https://github.com/mattly/iterm-colors-pencil)
+- [Alacritty-theme](https://github.com/eendroroy/alacritty-theme)
+- [base16-Alacritty](https://github.com/aarowill/base16-alacritty)
+- [base16](https://github.com/chriskempson/base16)
+- [Solarized](https://ethanschoonover.com/solarized/)
+- [Dracula](https://draculatheme.com/)
+- [Gruvbox](https://github.com/morhetz/gruvbox)
+
+## What are base16 themes?
+> An architecture for building themes based on carefully chosen syntax highlighting using a base of sixteen colors. Base16 provides a set of guidelines detailing how to style syntax and how to code a builder for compiling Base16 schemes and templates.
+
+More on the details and structure here: [https://github.com/chriskempson/base16.](https://github.com/chriskempson/base16)
+
+Base16 themes were sourced and auto-generated based on the Alacritty themes collected by @aarowill.
+Repo: [https://github.com/aarowill/base16-alacritty](https://github.com/aarowill/base16-alacritty)
+
+## What are standard themes?
 In this directory you'll find themes popular among other tools, including Solarized, Dracula and others.
 
-
 Themes in this directory were sourced and auto-generated based on the Alacritty themes collected by @eendroroy.
-Repo: https://github.com/eendroroy/alacritty-theme
+Repo: [https://github.com/eendroroy/alacritty-theme](https://github.com/eendroroy/alacritty-theme)
+
+## What are holiday themes?
+
+ We made holiday themes to celebrate various holidays during the calendar year.
+
+The [Thanksgiving Theme](https://twitter.com/warpdotdev/status/1463663176680157190?s=20) used [this background](https://unsplash.com/photos/ZwPuquZBnyM) taken by [
+Yannick Pulver](https://unsplash.com/@yanu).
+
+The [Winter Holiday Theme](https://twitter.com/warpdotdev/status/1474159550961840130?s=20&t=G8CKtGzU6kda5R3_gH9t4A) used [this background](https://unsplash.com/photos/TD8CbG9-sMk) taken by [Jeremy Kovac](https://unsplash.com/@jkovac).
+
+|Theme name | Preview|
+| --- | --- |
+
+
 |Theme name | Preview|
 | --- | --- |
 |**[Afterglow](afterglow.yaml)**:|<img src='previews/afterglow.yaml.svg' width='300'>|
diff --git a/readme.md-intro b/readme.md-intro
index d6c46a4..45988ef 100644
--- a/readme.md-intro
+++ b/readme.md-intro
@@ -1,5 +1,50 @@
+# Warp Themes
+
+This is an open source repository with themes for [Warp](https://www.warp.dev/).
+We welcome and appreciate any contributions!
+
+We have [directions on how to use this repository in our documentation.](https://docs.warp.dev/features/themes)
+
+[Discord](https://discord.gg/warpdotdev)
+
+[Warp Repo](https://github.com/warpdotdev/Warp)
+
+## Open source dependencies
+
+We'd like to call out a few of the open source themes and repositories that helped bootstrap the set of themes for Warp:
+
+- [iTerm colors pencil](https://github.com/mattly/iterm-colors-pencil)
+- [Alacritty-theme](https://github.com/eendroroy/alacritty-theme)
+- [base16-Alacritty](https://github.com/aarowill/base16-alacritty)
+- [base16](https://github.com/chriskempson/base16)
+- [Solarized](https://ethanschoonover.com/solarized/)
+- [Dracula](https://draculatheme.com/)
+- [Gruvbox](https://github.com/morhetz/gruvbox)
+
+## What are base16 themes?
+> An architecture for building themes based on carefully chosen syntax highlighting using a base of sixteen colors. Base16 provides a set of guidelines detailing how to style syntax and how to code a builder for compiling Base16 schemes and templates.
+
+More on the details and structure here: [https://github.com/chriskempson/base16.](https://github.com/chriskempson/base16)
+
+Base16 themes were sourced and auto-generated based on the Alacritty themes collected by @aarowill.
+Repo: [https://github.com/aarowill/base16-alacritty](https://github.com/aarowill/base16-alacritty)
+
+## What are standard themes?
 In this directory you'll find themes popular among other tools, including Solarized, Dracula and others.
 
-
 Themes in this directory were sourced and auto-generated based on the Alacritty themes collected by @eendroroy.
-Repo: https://github.com/eendroroy/alacritty-theme
+Repo: [https://github.com/eendroroy/alacritty-theme](https://github.com/eendroroy/alacritty-theme)
+
+## What are holiday themes?
+
+ We made holiday themes to celebrate various holidays during the calendar year.
+
+The [Thanksgiving Theme](https://twitter.com/warpdotdev/status/1463663176680157190?s=20) used [this background](https://unsplash.com/photos/ZwPuquZBnyM) taken by [
+Yannick Pulver](https://unsplash.com/@yanu).
+
+The [Winter Holiday Theme](https://twitter.com/warpdotdev/status/1474159550961840130?s=20&t=G8CKtGzU6kda5R3_gH9t4A) used [this background](https://unsplash.com/photos/TD8CbG9-sMk) taken by [Jeremy Kovac](https://unsplash.com/@jkovac).
+
+|Theme name | Preview|
+| --- | --- |
+
+