Skip to content

docs: add NestJS backend API tutorial#37

Merged
fungc-io merged 1 commit into
authgear:mainfrom
fungc-io:nestjs-backend-tutorial
Jun 16, 2026
Merged

docs: add NestJS backend API tutorial#37
fungc-io merged 1 commit into
authgear:mainfrom
fungc-io:nestjs-backend-tutorial

Conversation

@fungc-io

@fungc-io fungc-io commented Jun 15, 2026

Copy link
Copy Markdown
Member

Summary

Adds a Get Started → Backend/API Integration tutorial for protecting a NestJS API with the @authgear/nestjs SDK.

  • New page get-started/backend-api/nestjs.md — Portal setup (enable Issue JWT as access token), AuthgearModule.forRootAsync with a global guard, @Public() / @CurrentUser(), run & test with curl.
  • Registered in SUMMARY.md under Backend/API Integration (next to "Validate JWT in your backend").
  • Cross-linked from the generic jwt.md guide.

Placed under Backend/API Integration (not Regular Web App) because the SDK is a resource server — it validates tokens and does not perform the login flow. The tutorial makes that scope explicit and points users to the SPA/mobile guides for obtaining tokens.

Notes

  • Links to the example repo authgear/authgear-example-nestjs, which is not created yet — that repo should be published before/with merge.

Test Plan

  • Verify the new page renders in GitBook and appears in the nav under Backend/API Integration
  • Confirm relative links resolve (jwt.md, ../single-page-app/, ../native-mobile-app/, ../../reference/tokens/jwt-access-token.md)
  • Confirm the example-repo link once authgear-example-nestjs exists

🤖 Generated with Claude Code

Add a Get Started > Backend/API Integration guide for protecting a NestJS
API with the @authgear/nestjs SDK (module, guard, @Public/@currentuser).
Register it in SUMMARY.md and cross-link from the generic JWT guide.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@fungc-io fungc-io merged commit 678d437 into authgear:main Jun 16, 2026
2 checks passed
@fungc-io fungc-io deleted the nestjs-backend-tutorial branch June 16, 2026 12:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant