"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; const headings = [{ "data": { "id": "get-started", "hProperties": { "id": "get-started" } }, "depth": 2, "value": "Get started" }, { "data": { "id": "integrate-logto-sdk", "hProperties": { "id": "integrate-logto-sdk" } }, "depth": 2, "value": "Integrate Logto SDK" }, { "data": { "id": "installation", "hProperties": { "id": "installation" } }, "depth": 3, "value": "Installation" }, { "data": { "id": "register-logto-module", "hProperties": { "id": "register-logto-module" } }, "depth": 3, "value": "Register Logto module" }, { "data": { "id": "implement-sign-in-and-sign-out", "hProperties": { "id": "implement-sign-in-and-sign-out" } }, "depth": 3, "value": "Implement sign-in and sign-out" }, { "data": { "id": "display-user-information", "hProperties": { "id": "display-user-information" } }, "depth": 3, "value": "Display user information" }, { "data": { "id": "checkpoint-run-the-application", "hProperties": { "id": "checkpoint-run-the-application" } }, "depth": 2, "value": "Checkpoint: Run the application" }, { "data": { "id": "further-readings", "hProperties": { "id": "further-readings" } }, "depth": 2, "value": "Further readings" }]; const readingTime = { "minutes": 1, "words": 333, "text": "less than a minute read" }; const frontmatter = undefined; function _createMdxContent(props) { const _components = { a: "a", code: "code", h2: "h2", h3: "h3", li: "li", p: "p", pre: "pre", span: "span", ul: "ul", ..._provideComponents(), ...props.components }, {Checkpoint, ConfigureRedirectUris, GetStarted, LogtoCloudButton} = _components; if (!Checkpoint) _missingMdxReference("Checkpoint", true); if (!ConfigureRedirectUris) _missingMdxReference("ConfigureRedirectUris", true); if (!GetStarted) _missingMdxReference("GetStarted", true); if (!LogtoCloudButton) _missingMdxReference("LogtoCloudButton", true); return _jsxs(_Fragment, { children: [_jsxs(_components.h2, { id: "get-started", children: ["Get started", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#get-started", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(GetStarted, { framework: { name: 'Nuxt', url: 'https://nuxt.com/', description: 'an open source framework that makes web development intuitive and powerful.' }, programmingLanguage: "TypeScript", applicationType: "Traditional web" }), "\n", _jsxs(_components.h2, { id: "integrate-logto-sdk", children: ["Integrate Logto SDK", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#integrate-logto-sdk", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.h3, { id: "installation", children: ["Installation", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#installation", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.p, { children: "Install Logto SDK via your favorite package manager:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "# or pnpm, yarn, etc.\nnpm i @logto/nuxt\n" }) }), "\n", _jsxs(_components.h3, { id: "register-logto-module", children: ["Register Logto module", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#register-logto-module", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: ["In your Nuxt config file (", _jsx(_components.code, { children: "nuxt.config.ts" }), "), add the Logto module:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-ts", children: "export default defineNuxtConfig({\n modules: ['@logto/nuxt'],\n // ...other configurations\n});\n" }) }), "\n", _jsx(_components.p, { children: "The minimal configuration for the module is as follows:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-ts", children: "export default defineNuxtConfig({\n modules: ['@logto/nuxt'],\n runtimeConfig: {\n logto: {\n endpoint: '',\n appId: '',\n appSecret: '',\n cookieEncryptionKey: '',\n },\n },\n // ...other configurations\n});\n" }) }), "\n", _jsx(_components.p, { children: "Since these information are sensitive, it's recommended to use environment variables:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "# .env file\nNUXT_LOGTO_ENDPOINT=\"\"\nNUXT_LOGTO_APP_ID=\"\"\nNUXT_LOGTO_APP_SECRET=\"\"\nNUXT_LOGTO_COOKIE_ENCRYPTION_KEY=\"\"\n" }) }), "\n", _jsxs(_components.p, { children: ["See ", _jsx(_components.a, { href: "https://nuxt.com/docs/guide/going-further/runtime-config", children: "runtime config" }), " for more information."] }), "\n", _jsxs(_components.h3, { id: "implement-sign-in-and-sign-out", children: ["Implement sign-in and sign-out", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#implement-sign-in-and-sign-out", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(ConfigureRedirectUris, {}), "\n", _jsxs(_components.p, { children: ["When registering ", _jsx(_components.code, { children: "@logto/nuxt" }), " module, it will do the following:"] }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Add three routes for sign-in (", _jsx(_components.code, { children: "/sign-in" }), "), sign-out (", _jsx(_components.code, { children: "/sign-out" }), "), and callback (", _jsx(_components.code, { children: "/callback" }), ")."] }), "\n", _jsxs(_components.li, { children: ["Import two composables: ", _jsx(_components.code, { children: "useLogtoClient" }), " and ", _jsx(_components.code, { children: "useLogtoUser" }), "."] }), "\n"] }), "\n", _jsxs(_components.p, { children: ["These routes are configurable via ", _jsx(_components.code, { children: "logto.pathnames" }), " in the module options, for example:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-ts", children: "export default defineNuxtConfig({\n logto: {\n pathnames: {\n signIn: '/login',\n signOut: '/logout',\n callback: '/auth/callback',\n },\n },\n // ...other configurations\n});\n" }) }), "\n", _jsxs(_components.p, { children: ["Check out the ", _jsx(_components.a, { href: "https://github.com/logto-io/js/blob/HEAD/packages/nuxt/src/runtime/utils/types.ts", children: "type definition file" }), " in the ", _jsx(_components.code, { children: "@logto/nuxt" }), " package for more information."] }), "\n", _jsx(_components.p, { children: "Since Nuxt pages will be hydrated and become a single-page application (SPA) after the initial load, we need to redirect the user to the sign-in or sign-out route when needed." }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-html", children: "Sign in\n
\nSign out\n" }) }), "\n", _jsxs(_components.h3, { id: "display-user-information", children: ["Display user information", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#display-user-information", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: ["To display the user's information, you can use the ", _jsx(_components.code, { children: "useLogtoUser()" }), " composable, which is availble on both server and client side:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-html", children: "\n\n" }) }), "\n", _jsxs(_components.h2, { id: "checkpoint-run-the-application", children: ["Checkpoint: Run the application", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#checkpoint-run-the-application", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(Checkpoint, {}), "\n", _jsxs(_components.h2, { id: "further-readings", children: ["Further readings", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#further-readings", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.ul, { children: ["\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/customize-sie/", children: "Customize sign-in experience" }) }), "\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/configure-connectors/", children: "Configure connectors" }) }), "\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/protect-your-api/", children: "Protect your API" }) }), "\n"] }), "\n", _jsx(LogtoCloudButton, { children: "Try Logto Today" })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = { ..._provideComponents(), ...props.components }; return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { headings, readingTime, frontmatter, default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }