> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tariqdev.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO

> Customize Sonata metadata, Open Graph images, Twitter cards, sitemap-friendly content, and theme color.

# SEO

Global SEO config is managed through:

```txt theme={null}
lib/config/site.ts
app/layout.tsx
```

<Info>
  SEO changes work best when metadata, page copy, product names, and Open Graph images describe the same brand and offer.
</Info>

## Site URL

Set the production domain:

```ts theme={null}
url: "https://sonata.id"
```

This is used for metadata base, canonical URLs, and author links.

Use the real production domain before generating previews or sharing links publicly.

## Metadata

Update:

```ts theme={null}
seo: {
  title: "...",
  titleTemplate: "...",
  description: "...",
  keywords: ["..."],
  ogTitle: "...",
  ogDescription: "...",
  ogImage: "...",
  ogImageAlt: "...",
  themeColor: "...",
  twitterTitle: "...",
  twitterDescription: "...",
}
```

## Open Graph Image

Recommended size:

```txt theme={null}
1200x630
```

Store it in:

```txt theme={null}
public/asset/metadata/
```

Then update `seo.ogImage`.

Good Open Graph images include:

* Brand name.
* Main product category.
* Clear contrast.
* Minimal text.
* Real UI preview or product visual.

Avoid tiny screenshots that become unreadable in chat previews.

## Theme Color

Match this with your accent:

```ts theme={null}
themeColor: "#9333ea"
```

Also update browser and PWA icons if you rebrand heavily.

## Page-Level SEO

Some pages export their own metadata.

Examples:

```txt theme={null}
app/game-host/page.tsx
```

When adding a new important public page, add metadata if needed.

## Page Copy

Use natural hosting keywords where they belong:

* Game server hosting.
* Minecraft hosting.
* Web hosting.
* VPS hosting.
* App hosting.
* Domain registration.
* Private node hosting.

Do not repeat keywords unnaturally. Product clarity matters more than keyword stuffing.

## Metadata Testing

After deployment, test previews in:

* Discord.
* X/Twitter card validator.
* Facebook Sharing Debugger.
* Search result preview tools.

If a preview shows old data, the platform may be caching your metadata.

## SEO Checklist

* Production URL is correct.
* Title and description are not placeholders.
* Open Graph image exists.
* Twitter card metadata is correct.
* Favicon and app icons are replaced.
* Product pages use real copy.
* Legal pages are accurate.
* Domain and billing URLs are production-ready.