diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..296da36
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Logo.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 899cffb..f73f703 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,224 @@
+
+
+# Logo.dev
+
+### Every company logo, one API request
+
+**The highest-quality logo and brand API.** Pass a domain, ticker, or crypto symbol — get back a clean, correctly-sized logo, served from a global CDN. No sourcing, no hosting, no broken images.
+
+[](https://www.logo.dev)
+[](https://docs.logo.dev)
+[](https://www.logo.dev/signup)
+[](LICENSE)
+
+**50M+ companies** · **30M+ requests/day** · **55K+ developers** · **<50ms median** · **150+ edge locations** · **500K free/mo**
+
+
+
+---
+
+## One `
+More languages — Next.js, Vue, Ruby, PHP, Swift (iOS), Kotlin (Android), Google Sheets & Excel
+
+---
+
+## Migrating from Clearbit
+
+**Clearbit's Logo API shut down on December 8, 2025.** If your app still points at `logo.clearbit.com`, the logos are broken.
+
+**We're the same team that originally built the Clearbit Logo API**, and logo.dev is the migration path recommended by Clearbit / HubSpot. It's a drop-in replacement — swap the base URL and add a token. Your existing parameters keep working.
+
+```diff
+- https://logo.clearbit.com/stripe.com
++ https://img.logo.dev/stripe.com?token=LOGO_DEV_PUBLISHABLE_KEY
+```
+
+Most migrations take a few minutes. Full guide: **[Migrating from Clearbit →](https://docs.logo.dev/migrations/clearbit)**
+
+> "We built logo enrichment at Clearbit because developers needed it. Logo.dev is what I wish we could have built. Comprehensive, fast, and they actually keep the logos updated. Clear upgrade."
+>
+> — **Alex MacCaw**, Founder, Clearbit
+
+---
+
+## Trusted by developers
+
+`55K+` developers build on logo.dev — from CRMs and fintech dashboards to AI products.
+
+
+
+---
+
+## Use logo.dev logos in your own README or site
+
+Because every logo is just an `Logos provided by Logo.dev
+```
+
+Prefer a badge? Drop in [`assets/powered-by-logo-dev.svg`](assets/powered-by-logo-dev.svg):
+
+[
+ Powered by Logo.dev
+
+
+ Powered by Logo.dev
+
+```
+
+That's the whole integration. Swap `stripe.com` for any domain and you get a crisp, correctly-sized logo back in milliseconds.
+
+
+
+---
+
+## Why logo.dev
+
+- **No infrastructure.** No scraping, storing, resizing, or cache-busting. A URL is the integration.
+- **One tag, every framework.** It's just an image — drop it into HTML, React, Vue, iOS, Android, or a spreadsheet.
+- **Built for production.** A global CDN with a `<50ms` median response across `150+` edge locations.
+- **Always current.** `50M+` companies, updated daily — no stale or broken logos.
+- **Flexible output.** Size, retina, format (`PNG`/`WebP`), and light/dark `theme` variants via query params.
+- **More than logos.** Resolve companies by stock ticker or crypto symbol, search brands by name, or pull structured brand data.
+
+---
+
+## Endpoints
+
+Every logo is a `GET` against `img.logo.dev`. The REST endpoints return structured brand data.
+
+| Lookup | Example | Docs |
+| --- | --- | --- |
+| **By domain** | `img.logo.dev/stripe.com` | [Logo images →](https://docs.logo.dev/logo-images/introduction) |
+| **By stock ticker** | `img.logo.dev/ticker/AAPL` | [Ticker →](https://docs.logo.dev/logo-images/ticker) |
+| **By crypto symbol** | `img.logo.dev/crypto/BTC` | [Crypto →](https://docs.logo.dev/logo-images/crypto) |
+| **By company name** | `img.logo.dev/name/stripe` | [Name →](https://docs.logo.dev/logo-images/name) |
+| **Brand Search** | Find a company when you only have a name | [Brand Search →](https://docs.logo.dev/brand-search/introduction) |
+| **Describe** | Colors, socials, and structured brand fields | [Describe →](https://docs.logo.dev/describe/introduction) |
+
+Common parameters: `token` (required), `size`, `retina`, `format`, `theme`. Full reference at [docs.logo.dev](https://docs.logo.dev).
+
+---
+
+## Quickstart
+
+Lead with HTML, then reach for your stack. Every snippet uses the same CDN URL — only the wrapper changes.
+
+```html
+
+
+ );
+}
+```
+
+```bash
+# cURL
+curl "https://img.logo.dev/stripe.com?token=LOGO_DEV_PUBLISHABLE_KEY&size=128&format=png" --output stripe.png
+```
+
+```python
+# Python
+import requests
+
+def get_company_logo(domain: str) -> bytes:
+ url = f"https://img.logo.dev/{domain}?token=LOGO_DEV_PUBLISHABLE_KEY"
+ return requests.get(url).content
+```
+
+
+```
+
+On the **free plan, commercial use requires a visible link back**; personal projects don't. Add this wherever you display logos:
+
+```html
+Logos provided by Logo.dev
+```
+
+Prefer a badge? Drop in [`assets/powered-by-logo-dev.svg`](assets/powered-by-logo-dev.svg):
+
+[
](https://logo.dev)
+
+```html
+
+