Configuration File:
config/seo.tsOverview
The SEO configuration controls all search engine optimization across your website:- Global SEO settings (site URL, name, default images)
- Page-specific meta tags and descriptions
- Game-specific SEO for individual game pages
- Open Graph for social media sharing
- Twitter Cards configuration
- Robots and indexing settings
- Verification codes for search consoles
config/seo.ts
Quick Start
1
Set global settings
Open
config/seo.ts and update:2
Configure page SEO
Update titles and descriptions for each page
3
Test with meta tag preview
Visit https://metatags.io to preview how pages look on social media
Global SEO Settings
Key Fields
- siteUrl: Your website’s base URL (used for canonical URLs)
- defaultOgImage: Fallback image for social sharing (1200x630px)
- titleSeparator: How to separate page title from site name
- robots: Control search engine crawling behavior
- verification: Add verification codes from search console tools
Page-Specific SEO
Define SEO for each page:SEO Best Practices
Title (50-60 characters ideal):- Include main keyword near the start
- Make it compelling and clickable
- Don’t stuff with keywords
- Write for humans, not robots
- Include a call-to-action
- Mention key benefits or features
- Comma-separated phrases
- Less important for modern SEO
- Focus on natural content instead
Game-Specific SEO
Customize SEO for individual game pages:Open Graph Images
Social media preview images should be:- Size: 1200x630 pixels
- Format: JPG or PNG
- Location:
/public/folder - Content: Logo, tagline, and relevant imagery
- Text: Large and readable (minimum 20% of image)
/public/:
Helper Functions
The config includes helper functions (you don’t need to edit these):Complete Example
Best Practices
General SEO
- Unique titles/descriptions - Every page should be different
- Include keywords naturally - Don’t force them
- Write for humans first - Make it compelling
- Keep it concise - Respect character limits
- Update regularly - Refresh content as offerings change
Open Graph
- Create custom images - Generic images get ignored
- Test before deploying - Use metatags.io preview
- Include branding - Logo should be visible
- Optimize file size - Compress images (<500KB)
Technical
- Use HTTPS siteUrl - Required for canonical URLs
- Set correct locale - en_US, en_GB, etc.
- Add verification codes - Once verified in search consoles
- Monitor robots.txt - Ensure it doesn’t block important pages
Troubleshooting
Social media not showing custom image
- Clear social media cache:
- Verify image is exactly 1200x630px
- Check image URL starts with
https:// - Ensure image is in
/public/folder
Page not indexed by Google
- Check
robots.indexis true - Submit sitemap to Google Search Console
- Verify robots.txt doesn’t block page
- Check for noindex meta tag on page
Wrong title showing
Title format:pageTitle | siteName
If seeing wrong title, check:
pageSeohas correct title for the pagetitleSeparatoris set correctly- Browser cache (hard refresh: Ctrl+Shift+R)

