Thinkmill / Thinkmill/keystatic

Keystatic (Cloud) does not indicate it is not setup correctly

Open
#1,141 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
2.4k
Forks
159
Avg merge
21h 41m
Merged PRs (30d)
2

Description

This may be an edge case, but I think it would be great if addressed:

Steps to reproduce:

  1. Install Keystatic Cloud GitHub app in a select repository (do not give it full access)
  2. Setup project on Keystatic Cloud
  3. Push local project (Astro in my case) to different remote than that setup in step 2
  4. Assign URL to access Keystatic dashboard in production
  5. Head to /keystatic in production

Result:

An empty page. No errors in the console. Network tab shows 200 for hits to Keystatic Cloud GQL API. However, you cannot see the dashboard.

Fix:

I had to create an entirely new project on Keystatic Cloud, and ensure I pointed the project to the right GitHub repository. Thereafter, everything works as expected.


Is this something that just needs to be mentioned in the docs? Or do you guys think that Keystatic should handle this edge case?

PS: Thanks for working on Keystatic! 💖

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 at the production /keystatic entry point and inspect requests to the Keystatic Cloud GQL API using the reproduction steps. Compare behavior when the deployed project points to the configured GitHub repository versus a different remote. Done means the mismatch produces a clear setup error or is explicitly documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, graphql, typescript
Domain
api, cloud
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.