shipshapecode / shipshapecode/starpod

Contact page has too little real content for agent trust checks

Open
#69 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
89
Forks
30
Avg merge
7h 41m
Merged PRs (30d)
14

Description

Context

An is-agentic.com scan of whiskey.fm (95/100 overall — this platform already does a lot right for agent discoverability: llms.txt, markdown twins, OpenAPI, agent-friendly 404s) flagged one "trust anchor" gap:

About, Privacy pages verified - missing: Contact
Publish real /about, /contact, and /privacy pages with at least 500 characters of content each. These are the pages AI agents check to verify your business is legitimate before recommending you.

Current state

packages/starpod/src/pages/contact.astro is just an <h1>, one ~130-character paragraph, and a client-hydrated form:

<h1>Get in touch</h1>
<p>
  Have a question for us or a topic you would like us to cover on the show?
  Reach out here and we'll be in touch soon!
</p>
<ContactForm client:load />

That's true for every site built on Starpod, not just whiskey.fm — this is a template issue.

(Side note while investigating: I couldn't find a /privacy route anywhere in the repo, and whiskey.fm/privacy 404s live, despite the scan reporting Privacy as "verified" — that check result may be unreliable/stale on its own. Flagging in case it's useful, but the actionable gap here is Contact.)

Proposed fix

Add enough real static copy to contact.astro to clear the ~500-character bar and give agents/crawlers something substantive without JS, e.g.:

  • A sentence or two on what kinds of messages are welcome (guest pitches, sponsorship, feedback, corrections)
  • A direct fallback contact method (an email address) for clients that can't or won't fill out a JS form — ContactForm is client:load, so a no-JS agent/crawler sees the static copy only
  • Maybe a link to the show's socials/hosts (already on /about) for people who'd rather reach out there

Could be baked into the shared template with configurable copy via starpod.config.ts, since the "what should go here" text is site-specific.

🤖 Filed with Claude Code

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with packages/starpod/src/pages/contact.astro and inspect how ContactForm is hydrated. Then read starpod.config.ts to see whether site-specific contact copy can be configured in the shared template. Done means the contact page has substantive static copy for crawlers, explains welcome messages, and provides a no-JavaScript fallback contact method.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
content, web-dev
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.