# omid.dev — Extended LLM site guide
# https://omid.dev/llms-full.txt

See also the concise guide: https://omid.dev/llms.txt

## About the author

Omid Farhang (omid.dev) is a Frontend Architect and Engineering Lead with 10+ years building and scaling web platforms. Primary stack: Angular, TypeScript, Nx monorepos, design systems, CI/CD, and platform governance. Background includes Linux, networking, and DevOps.

## Site structure

| Section | URL | Notes |
|---------|-----|-------|
| Home | https://omid.dev/ | Profile, featured posts, topic tags |
| Posts | https://omid.dev/posts/ | Tech blog archive (~1800+ posts, mostly English) |
| TechBlog hub | https://omid.dev/posts/techblog/ | Reading paths, series highlights, chronological archive |
| Series index | https://omid.dev/series/ | All ordered post series (overview + deep dives) |
| Reading paths | https://omid.dev/posts/techblog/paths/ | Curated lists: Angular Platform, Engineering Leadership, Systems & Linux, Frontend Quality, AI & Data Tools, Frontend Architecture |
| Categories | https://omid.dev/categories/ | Taxonomy |
| Tags | https://omid.dev/tags/ | Taxonomy |
| About | https://omid.dev/about-me/ | Bio and background |
| Resume | https://omid.dev/resume/ | Structured CV (JSON-LD Person on page) |
| Contact | https://omid.dev/contact-me/ | Contact form |
| Now | https://omid.dev/now/ | Current focus |
| Uses | https://omid.dev/uses/ | Tools and setup |
| Search | https://omid.dev/search/ | Client-side search over index.json |

Persian (`/fa/`) and German (`/de/`) mirror key pages; most blog posts are English-only. Paired translations exist for select pages and ~90+ posts.

## Companion code & live demos

Many technical posts on omid.dev link to runnable companion projects. This is separate from the blog itself but tightly coupled to it.

| Resource | URL | Notes |
|----------|-----|-------|
| Source repository | https://github.com/omidfarhang/example-projects | 20+ self-contained examples and labs with READMEs and run instructions |
| Live playground | https://playground.omid.dev/ | Browser-only demos at `/examples/<slug>/` and interactive labs at `/labs/<slug>/` |
| Announcement post | https://omid.dev/2026/06/01/why-i-started-adding-full-source-code-to-my-blog-posts/ | Explains the companion-code approach |

Not every post has a full app. Some companions are source-only (Firebase, API servers, native Linux tools, notebooks). Posts that support live demos use a companion shortcode linking to the repo and, when applicable, playground.omid.dev.

## Post URL pattern

English posts: `https://omid.dev/{year}/{month}/{day}/{slug}/`

Many posts include a `shortlink` (g.omid.dev) in front matter; the canonical URL for indexing is always the omid.dev permalink.

## Feeds and indexes

- RSS: https://omid.dev/index.xml (20 most recent items per language home)
- Search JSON: https://omid.dev/index.json — array of `{title, permalink, summary, tags, categories, date}` for Fuse.js search
- Sitemap: https://omid.dev/sitemap.xml — multilingual with hreflang alternates

## Structured data (production pages)

- Home: schema.org Person + WebSite with SearchAction
- Blog posts: BlogPosting + BreadcrumbList
- Resume: Person with credentials and roles

## Social profiles (sameAs)

- LinkedIn: https://linkedin.com/in/omidfarhang
- GitHub: https://github.com/omidfarhang
- X: https://x.com/omidfarhang
- Bluesky: https://bsky.app/profile/omid.dev
- Mastodon: https://mastodon.social/@omidfarhang

## AI usage

See https://omid.dev/ai.txt for licensing and training preferences.