I shipped a Next.js app last year and felt pretty good about it — clean code, fast load times, Lighthouse scores in the green. Then I noticed Google had indexed exactly one page. The homepage.

Nothing else. Turns out I'd built the entire thing with App Router and assumed metadata would "just work." It didn't. After three hours of documentation rabbit holes, I discovered the problem wasn't my conte