docs: move Getting Started to a single page

[balazsorban44]

Our documentation is currently hard to navigate and is spread in too many pages. This greatly simplifies things and removes some redundancy, hopefully also improving the search functionality to not return so many results from so many pages.

• Before merge, make sure to fix broken links

☕️ Reasoning

🧢 Checklist

• Documentation
• Tests
• Ready to be merged

🎫 Affected issues

📌 Resources

• Security guidelines
• Contributing guidelines
• Code of conduct
• Contributing to Open Source

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
auth-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 19, 2025 1:18pm

2 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
next-auth-docs	⬜️ Ignored (Inspect)	Visit Preview		Jan 19, 2025 1:18pm
proxy	⬜️ Ignored (Inspect)	Visit Preview		Jan 19, 2025 1:18pm

[socket-security]

New, updated, and removed dependencies detected. Learn more about Socket for GitHub ↗︎

Package	New capabilities	Transitives	Size	Publisher
npm/@ariakit/[email protected]	None	+5	4.13 MB	ariakit-bot
npm/@aws-sdk/[email protected]	Transitive: environment, filesystem, shell	+28	3.7 MB	aws-sdk-bot
npm/@aws-sdk/[email protected]	None	+1	261 kB	aws-sdk-bot
npm/@azure/[email protected]	Transitive: environment, network	+9	3.17 MB	azure-sdk
npm/@balazsorban/[email protected]	Transitive: environment	+4	105 kB	balazsorban
npm/@builder.io/[email protected]	eval, network	0	2.37 MB	adamdbradley
npm/@builder.io/[email protected]	eval	0	45.6 MB	shairez
npm/@cloudflare/[email protected]	None	0	2.69 MB	wrangler-publisher
npm/@eslint/[email protected]	None	0	47.7 kB	eslintbot
npm/@eslint/[email protected]	None	0	14.2 kB	eslintbot
npm/[email protected]	environment, eval, filesystem, network, shell, unsafe	0	3.26 MB	vitebot

🚮 Removed packages: npm/@actions/[email protected], npm/@auth/[email protected], npm/@sveltejs/[email protected], npm/@sveltejs/[email protected], npm/@sveltejs/[email protected], npm/@types/[email protected], npm/[email protected], npm/[email protected], npm/[email protected], npm/[email protected], npm/[email protected], npm/[email protected]

View full report↗︎

[github-actions]

Broken Link Checker

71 broken links found. Links organised below by source page, or page where they were found.

1) /

Target Link	Link Text
/getting-started/integrations	"More"

2) /getting-started/migrating-to-v5

Target Link	Link Text
/getting-started/installation	"Installation"
/getting-started/deployment	"Read more"
/getting-started/session-management/protecting	"Middleware docs"
/getting-started/database	"adapters page"

3) /getting-started

Target Link	Link Text
/reference/rest-api	"REST API"
/getting-started/authentication/oauth	"OAuthproviders"
/getting-started/authentication/email	"Email MagicLinks"
/getting-started/authentication/webauthn	"WebAuthn(Passkeys)"
/getting-started/typescript	"augment the Userinterface"
/getting-started/database	"database"
/errors	"errors"
/warnings	"warnings"
/about	"examples"

4) /guides/configuring-oauth-providers

Target Link	Link Text
/getting-started/authentication/oauth	"built-in OAuth providers"

5) /guides/configuring-github

Target Link	Link Text
/getting-started/installation	"installation instructions"
/getting-started/installation	"installation section"
/getting-started/deployment	"Deployment page"

6) /getting-started/providers/42-school

Target Link	Link Text
/getting-started/database	"database adapter"

7) /getting-started/providers/credentials

Target Link	Link Text
/getting-started/authentication/credentials	"Client-side Input Validation Example"

8) /getting-started/providers/sailpoint

Target Link	Link Text
/getting-started/database	"User table"

9) /guides/environment-variables

Target Link	Link Text
/getting-started/deployment	"Deployment"
/getting-started/authentication/oauth	"official OAuth provider"

10) /concepts/session-strategies

Target Link	Link Text
/getting-started/database	"officialdatabase adapters"

11) /guides/edge-compatibility

Target Link	Link Text
/getting-started/session-management/protecting	"session management docs"
/getting-started/session-management/protecting	"protecting your routes"

12) /guides/extending-the-session

Target Link	Link Text
/getting-started/typescript	"TypeScript"

13) /guides/role-based-access-control

Target Link	Link Text
/getting-started/session-management/protecting	"Middleware"
/getting-started/database	"Adapters: User model"
/getting-started/session-management/protecting	"Next.js: Middleware"
/getting-started/typescript	"TypeScript"

14) /guides/configuring-resend

Target Link	Link Text
/getting-started/installation	"installation instructions"
/getting-started/installation	"installation section"
/getting-started/deployment	"Deployment page"

15) /guides/creating-a-framework-integration

Target Link	Link Text
/getting-started/integrations	"list of integrations"

16) /getting-started

Target Link	Link Text
/reference/rest-api	"REST API"
/getting-started/authentication/oauth	"OAuthproviders"
/getting-started/authentication/email	"Email MagicLinks"
/getting-started/authentication/webauthn	"WebAuthn(Passkeys)"
/getting-started/typescript	"augment the Userinterface"
/getting-started/database	"database"
/errors	"errors"
/warnings	"warnings"
/about	"examples"

17) /getting-started

Target Link	Link Text
/reference/rest-api	"REST API"
/getting-started/authentication/oauth	"OAuthproviders"
/getting-started/authentication/email	"Email MagicLinks"
/getting-started/authentication/webauthn	"WebAuthn(Passkeys)"
/getting-started/typescript	"augment the Userinterface"
/getting-started/database	"database"
/errors	"errors"
/warnings	"warnings"
/about	"examples"

18) /getting-started

Target Link	Link Text
/reference/rest-api	"REST API"
/getting-started/authentication/oauth	"OAuthproviders"
/getting-started/authentication/email	"Email MagicLinks"
/getting-started/authentication/webauthn	"WebAuthn(Passkeys)"
/getting-started/typescript	"augment the Userinterface"
/getting-started/database	"database"
/errors	"errors"
/warnings	"warnings"
/about	"examples"

19) /getting-started

Target Link	Link Text
/reference/rest-api	"REST API"
/getting-started/authentication/oauth	"OAuthproviders"
/getting-started/authentication/email	"Email MagicLinks"
/getting-started/authentication/webauthn	"WebAuthn(Passkeys)"
/getting-started/typescript	"augment the Userinterface"
/getting-started/database	"database"
/errors	"errors"
/warnings	"warnings"
/about	"examples"