5 Commits

Include renames

Author	SHA1	Message	Date
MadisonandGitHub	f3d0a68720	[Docs][Content] - Updates Example Pages -> Vite Vanilla JS examples (#1050) ... <!-- Make sure you've read the CONTRIBUTING.md guidelines: https://github.com/stack-auth/stack-auth/blob/dev/CONTRIBUTING.md --> feat(docs): centralize code examples with dynamic variant tabs This PR introduces a system for managing code examples centrally while supporting file-based variant tabs (like html/script) within a single code block. ## Changes - **Extended variant system**: `PlatformCodeblock` now supports custom variant names beyond just 'server'/'client', enabling tabs for any file grouping (e.g., html/script pairs) - **Vite example migration**: Moved vite-example.mdx code to `code-examples/vite-example.ts` with html/script variants - **LLM copy support**: The "Copy Markdown" button now expands `PlatformCodeblock` components to inline the actual code, so LLMs receive the full code examples instead of component references ## How it works Code examples with variants are now displayed with filename-based tabs: - Define examples with `variant: 'html'` and `variant: 'script'` in `code-examples/` - The tab labels automatically use the `filename` property - When copying markdown for LLMs, all variants are included with their filenames <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit ## Release Notes * **Documentation** * Added a Vite JavaScript example guide with grouped auth examples (init, index, password, OTP, OAuth) and wired examples into the getting-started navigation. * Removed the previous multi-page example guide and replaced it with the new Vite-focused page. * Documentation generation now expands platform code blocks to inline concrete examples for clearer rendered docs. * **Refactor** * Improved code-example variant handling to support flexible variant names for better tabbed/code-sample organization. <sub>✏️ Tip: You can customize this high-level summary in your review settings.</sub> <!-- end of auto-generated comment: release notes by coderabbit.ai -->	2025-12-22 08:53:51 -06:00
3 people	48c6f47448	Add API docs to llms.txt file. (#766) ... <!-- Make sure you've read the CONTRIBUTING.md guidelines: https://github.com/stack-auth/stack-auth/blob/dev/CONTRIBUTING.md --> Adds API docs to the llms.txt file for our agent to reference. Before, it was not capturing this information about the API. <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > Adds OpenAPI documentation extraction and formatting to `get-llm-text.ts` and updates Next.js configuration for ESLint and OpenAPI file handling. > > - **Behavior**: > - Adds `extractOpenAPIContent()` in `get-llm-text.ts` to extract OpenAPI content from API pages. > - Formats OpenAPI operations and specs using `formatOperation()` and `formatOpenAPISpec()`. > - Updates `getLLMText()` to return formatted OpenAPI content if available. > - **Configuration**: > - Changes `ignoreDuringBuilds` to `false` in `next.config.mjs` to enable ESLint during builds. > - Includes OpenAPI files in `outputFileTracingIncludes` for Vercel deployments in `next.config.mjs`. > > <sup>This description was created by </sup>[<img alt="Ellipsis" src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup> for f3b3d75a35. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> <!-- ELLIPSIS_HIDDEN --> --------- Co-authored-by: Konsti Wohlwend <[email protected]>	2025-07-15 11:13:32 -05:00
5 people	22235127b9	Docs updates (#753) ... <!-- Make sure you've read the CONTRIBUTING.md guidelines: https://github.com/stack-auth/stack-auth/blob/dev/CONTRIBUTING.md --> <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > This pull request updates the Stack Auth documentation structure, enhances navigation and layout functionalities, and introduces new components for improved user experience. > > - **Behavior**: > - Introduces `PlatformRedirect` component in `platform-redirect.tsx` for redirecting users to their preferred platform. > - Adds `usePlatformPreference` hook in `use-platform-preference.ts` for managing platform preferences. > - Updates `getSmartRedirectUrl()` in `navigation-utils.ts` to use `getSmartPlatformRedirect()`. > - **Layout and Navigation**: > - Enhances sidebar functionality with collapsible sections in `docs.tsx` and `sidebar-context.tsx`. > - Adds `DocsSidebarCollapseTrigger` in `docs.tsx` for sidebar collapse/expand functionality. > - Updates `SharedHeader` in `shared-header.tsx` to include platform-aware navigation links. > - **Documentation Structure**: > - Updates `meta.json` files in `templates` to reflect new documentation structure. > - Renames `overview.mdx` to `index.mdx` in `sdk` and `components` directories. > - Adds detailed documentation for `Team`, `TeamUser`, and `ContactChannel` in respective `.mdx` files. > > <sup>This description was created by </sup>[<img alt="Ellipsis" src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup> for 21e55737cb. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> <!-- ELLIPSIS_HIDDEN --> --------- Co-authored-by: Stack-Bot <[email protected]> Co-authored-by: ellipsis-dev[bot] <65095814+ellipsis-dev[bot]@users.noreply.github.com> Co-authored-by: Konsti Wohlwend <[email protected]>	2025-07-11 10:00:02 -07:00
3 people	a5734defba	Adds oauth providers, fixes bottom page navigation with mobile suppor… (#726) ... <!-- Fixes generation script, adds new oauth docs pages, fixes bottom navigation, adds mobile support, sidebar changes. --> <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > This PR adds OAuth provider documentation, enhances mobile navigation, and updates Python-specific documentation for Stack Auth. > > - **OAuth Providers**: > - Adds documentation for GitHub, Google, Facebook, Microsoft, Spotify, Discord, GitLab, Apple, Bitbucket, LinkedIn, and X (Twitter) in `docs/templates/concepts/auth-providers/`. > - Updates `docs/docs-platform.yml` to include new OAuth provider pages. > - **Mobile Support**: > - Enhances bottom navigation for mobile devices in `docs/src/app/(home)/layout.tsx` and `docs/src/app/api/layout.tsx`. > - Introduces `AIChatDrawer` and `AuthPanel` components for mobile-friendly interactions. > - **Documentation Enhancements**: > - Adds Python-specific documentation for user authentication and team management in `docs/templates-python/concepts/`. > - Updates `docs/templates-python/meta.json` to include new Python documentation pages. > - Refines search functionality and UI components for better user experience. > > <sup>This description was created by </sup>[<img alt="Ellipsis" src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup> for bf759151d8. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> <!-- ELLIPSIS_HIDDEN --> --------- Co-authored-by: Konsti Wohlwend <[email protected]>	2025-07-08 19:51:24 -07:00
5 people	717a385f3b	Llms.txt (#724) ... <!-- Adds llms.txt compatibility to the docs pages. --> --------- Co-authored-by: Konsti Wohlwend <[email protected]> Co-authored-by: Madison Kennedy <[email protected]> Co-authored-by: BilalG1 <[email protected]>	2025-06-27 13:28:55 -05:00