mirror of https://github.com/agentrhq/authsome.git synced 2026-09-19 01:34:19 +08:00

Files

T

Priyansh Khodiyar 857ec57205 chore: clean up stale repo references and skill provider bug

Two classes of bugs corrected, both verified against main at 69a0cb9.

Skill (skills/authsome/references/adding-provider.md):

- OAuth redirect URL was http://localhost:7999/callback. Source truth
  is http://127.0.0.1:7998/auth/callback/oauth (server/urls.py:8-9
  and the matching user-facing doc in custom-providers.mdx). Agents
  following the skill would tell users to register OAuth apps with
  a redirect URI that does not match what authsome actually serves,
  causing every PKCE login to fail.
- Step numbering had two "3." entries and no "4."; renumbered.
- Provider registration link pointed at the stale
  raw.githubusercontent.com/manojbajaj95/authsome fork; repointed
  to agentrhq.

Stale repo owner in actively-rendered surfaces:

- CONTRIBUTING.md: git clone URL.
- docs/site/README.md: link to the repo.
- docs/site/reference/bundled-providers.mdx: "open a pull request
  against" link in the upstream contribution section.
- docs/site/concepts/credential-storage.mdx: replaced
  "manojbajaj95" example label with "octocat" so the sample
  connection record reads as a generic GitHub username.
- src/authsome/ui/templates/_layout.html: dashboard sidebar
  "Support" link and topbar "GitHub" button.
- src/authsome/ui/templates/overview.html: dashboard "Contact Us"
  button on the overview page.

Out of scope:

- pyproject.toml author attribution stays as Manoj Bajaj; that is
  the actual maintainer's name, not a stale fork reference.
- CHANGELOG.md has ~100 manojbajaj95 commit URLs but release-please
  regenerates it; manual edits would be overwritten on next release.

2026-05-19 15:58:22 +05:30

1.5 KiB

Raw Permalink Blame History

authsome docs

The Mintlify documentation site for authsome.

Local preview

Requires Node.js >=20.17.0.

npm i -g mint
mint dev

The site renders at http://localhost:3000 with hot reload.

Validate before committing

mint broken-links     # check internal links
mint a11y             # check accessibility issues
mint validate         # run schema + content validation

Structure

docs/site/
  docs.json                    Mintlify config: theme, navigation, navbar
  index.mdx                    Landing page
  quickstart.mdx               First-run walkthrough
  guides/                      Task-oriented guides
  concepts/                    Architecture and core concepts
  reference/                   CLI, schema, env vars, bundled providers
  troubleshooting/             Diagnostic pages

Adding a page

Create the MDX file in the right subfolder.
Add it to the appropriate pages list in docs.json . pages not referenced in docs.json are hidden from the sidebar.
Run mint dev to preview, then mint broken-links and mint validate before opening a PR.

Style

Match the surrounding pages:

Sentence case for headings.
Code blocks always have a language tag.
Internal links use root-relative paths without file extensions: /guides/login-with-oauth, not ./login-with-oauth.mdx.
Prefer Mintlify components (<Steps>, <CodeGroup>, <Tabs>, <Card>, <Columns>, <Tip>, <Warning>) over plain Markdown when they help.

1.5 KiB Raw Permalink Blame History