I copied the docs route folder from this repo as a starting point but I keep getting this error, the only thing I changed in the folder is I removed the images (logo, and social card) and all the references to it, I also renamed layout to layout.reset because I have a root layout

I have a [dir].sidebar.json.js with the following code

import { createSidebarRequestHandler } from '@svelteness/kit-docs/node';

export const get = createSidebarRequestHandler();

and [slug].meta.json.js

import { createMetaRequestHandler } from '@svelteness/kit-docs/node';

export const get = createMetaRequestHandler();

this is my svelte config

import preprocess from 'svelte-preprocess';
import adapter from '@sveltejs/adapter-auto';
import {kitDocsPlugin} from '@svelteness/kit-docs/node'
import Icons from 'unplugin-icons/vite'

/** @type {import('@sveltejs/kit').Config} */
const config = {
	extensions: ['.svelte', '.md'],
	kit: {
		adapter: adapter(),
		vite:{
			optimizeDeps: {
				exclude: ['@urql/svelte', '@urql/core'],
			  },

			  plugins: [
				  Icons({compiler: 'svelte'}),
				  kitDocsPlugin({
					  shiki: {
						  theme: 'material-ocean'
					  },
				  }),
			  ],
			
		}
	},

	preprocess: [
		preprocess({
			postcss: true
		})
	]
};

export default config;

I always get the same error,

500
Unexpected token < in JSON at position 0
SyntaxError: Unexpected token < in JSON at position 0
    at JSON.parse (<anonymous>)
    at Proxy.<anonymous> (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:1797:21)
    at processTicksAndRejections (node:internal/process/task_queues:96:5)
    at async eval (/node_modules/@svelteness/kit-docs/client/loaders/index.js:22:22)
    at async load_node (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:1826:12)
    at async respond$1 (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:2177:15)
    at async render_page (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:2378:19)
    at async resolve (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:2610:11)
    at async respond (file:///Users/isaac/Desktop/projects/saffron/redo/frontend/.svelte-kit/runtime/server/index.js:2543:20)
    at async file:///Users/isaac/Desktop/projects/saffron/redo/frontend/node_modules/@sveltejs/kit/dist/chunks/index.js:244:24

This is a follow-on from #67.

• [x] demo package has to be updated.
• [ ] links resolution is wrong as it's resolving named page routes (i.e., index.svelte instead of +page.svelte). This is mostly in the node/handlers/index.ts file.
• [x] The glob in sitemap.xml seems to not be picking up an files strangely.

@mihar-22 I'm not quite sure what you mean by "links resolution is wrong"? Could you give more detail and I can try to fix it.

This is my repository https://github.com/stephane-klein/kit-docs-playground/tree/9049d03e2c84f6bf23b80559d26c1cdd57286a0d

When I execute:

$ npm install

I have this error:

$ npm install
npm WARN deprecated @types/[email protected]: This is a stub types definition. lru-cache provides its own type definitions, so you do not need this installed.

> [email protected] prepare
> svelte-kit sync

> config.kit.vite has been removed — use vite.config.js instead
    at file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:565:10
    at file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:457:43
    at file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:443:18
    at file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:443:18
    at validate_config (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:649:9)
    at process_config (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:626:20)
    at load_config (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/chunks/error.js:618:9)
    at async file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/node_modules/@sveltejs/kit/dist/cli.js:48:19
npm ERR! code 1
npm ERR! path /home/stephane/git/github.com/stephane-klein/kit-docs-playground
npm ERR! command failed
npm ERR! command sh -c svelte-kit sync

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/stephane/.npm/_logs/2022-07-05T21_02_20_132Z-debug-0.log

How can I fix this error?

npm run build doesn't work.

To reproduce:

$ npm init @svelteness/kit-docs mydocs
$ npm install

# development works
$ npm run dev

# build doesn't work
$ npm run build

The error messages is:

[vite]: Rollup failed to resolve import "@docsearch/js" from "node_modules/@svelteness/kit-docs/client/components/algolia/AlgoliaSearch.svelte".
This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`

This error can be resolved by adding the following to vite setting

// svelte.config.js
// under config.kit.vite setting

build: {
  rollupOptions: {
    external: ["@docsearch/js"],
  },
},

Now comes the second error:

file:///.svelte-kit/output/server/chunks/index-378e2722.js:4052
      const path2 = require("path");
                    ^
ReferenceError: require is not defined

In this fresh KitDocs project, I have Function called outside component initialization error.

Here is how to reproduce:

$ git clone [email protected]:stephane-klein/kit-docs-playground.git
$ git checkout -b issue 474b05c80e26816a8c69799008abde67bf5e897f
$ cd kit-docs-playground/services/kit-docs
$ pnpm install
$ pnpm run dev

Go to http://127.0.0.1:3000/, I have this error:

$ pnpm run dev                                                                                                                       130

> [email protected] dev /home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs
> vite dev


  vite v2.9.14 dev server running at:

  > Local: http://localhost:3000/
  > Network: use `--host` to expose

  ready in 739ms.

Function called outside component initialization
Error: Function called outside component initialization
    at get_current_component (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs:953:15)
    at Module.setContext (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs:985:5)
    at root.svelte:15:1
    at $$render (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs?v=8cb0458f:1755:22)
    at Object.render (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs?v=8cb0458f:1763:26)
    at render_response (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:1383:27)
    at async respond$1 (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:2996:4)
    at async resolve (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:3346:11)
    at async respond (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:3290:20)
    at async file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/node_modules/.pnpm/@[email protected][email protected][email protected]/node_modules/@sveltejs/kit/dist/vite.js:2324:22
(node:494086) ExperimentalWarning: buffer.Blob is an experimental feature. This feature could change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
Function called outside component initialization
Error: Function called outside component initialization
    at get_current_component (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs:953:15)
    at Module.setContext (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs:985:5)
    at root.svelte:15:1
    at $$render (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs?v=8cb0458f:1755:22)
    at Object.render (/node_modules/.pnpm/[email protected]/node_modules/svelte/internal/index.mjs?v=8cb0458f:1763:26)
    at render_response (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:1383:27)
    at async respond_with_error (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:2758:10)
    at async respond$1 (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:3013:4)
    at async resolve (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:3346:11)
    at async respond (file:///home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs/.svelte-kit/runtime/server/index.js:3290:20)

Versions:

$ pnpm list
Legend: production dependency, optional only, dev only

[email protected] /home/stephane/git/github.com/stephane-klein/kit-docs-playground/services/kit-docs

dependencies:
@fontsource/fira-mono 4.5.0
cookie 0.4.1

devDependencies:
@iconify-json/ri 1.1.1                eslint 8.16.0                         shiki 0.10.1
@sveltejs/adapter-auto 1.0.0-next.57  eslint-config-prettier 8.3.0          svelte 3.48.0
@sveltejs/kit 1.0.0-next.370          eslint-plugin-svelte3 4.0.0           unplugin-icons 0.13.4
@svelteness/kit-docs 0.23.0           prettier 2.6.2                        vite 2.9.14
clsx 1.1.1                            prettier-plugin-svelte 2.7.0

Have you an idea to fix this error?

Hi,

@mihar-22 What do you think about pin @sveltejs/adapter-auto and @sveltejs/kit version here to avoid some version errors like https://github.com/svelteness/kit-docs/issues/48 ?

Best regards, Stéphane

~~This is a best effort to migrate to the new routing system covering kit-docs (not the create module). I got the sidebar working and a lot of other small things. It may help you finish the integration. There are 3 unresolved issues:~~

1. ~~There is one issue with pnpm build - it needs the Response type in the node/handler.~~
2. ~~Run pnpm dev. There is a layout issue~~ fixed
3. ~~shiki config may need to be fixed for various languages.~~ Added languages manually. Not sure what the correct approach is.

I think I fixed all the major issues. kit-docs package seems to be working.

Thank you

See https://github.com/svelteness/kit-docs/issues/52#issuecomment-1186494202

@mihar-22 what do you think about this Pull Request, to pin create-svelte version to avoid SvelteKit breaking changes.

Fresh install with these commands:

npm init @svelteness/kit-docs docs
> Skeleton project
> Typescript
> eslint
cd docs
pnpm i
pnpm dev

Yields this error:

Error [ERR_MODULE_NOT_FOUND]: Cannot find package '$app' imported from ...\node_modules\.pnpm\@[email protected][email protected]\node_modules\@svelteness\kit-docs\client\polyfills\focus-visible.js
    at new NodeError (node:internal/errors:388:5)
    at packageResolve (node:internal/modules/esm/resolve:910:9)
    at moduleResolve (node:internal/modules/esm/resolve:959:20)
    at defaultResolve (node:internal/modules/esm/resolve:1174:11)
    at ESMLoader.resolve (node:internal/modules/esm/loader:605:30)
    at ESMLoader.getModuleJob (node:internal/modules/esm/loader:318:18)
    at ModuleWrap.<anonymous> (node:internal/modules/esm/module_job:80:40)
    at link (node:internal/modules/esm/module_job:78:36)

The culprit:

// @svelteness/kit-docs/client/polyfills/focus-visible.js
import { browser } from '$app/env';

$app would lead me to believe this is a missing alias?

On version 0.20.0 the dark theme is not applied, if I reload the page.

https://svelte-babylon.netlify.app/docs/introduction/getting-started#creating-a-project

The mode is correctly being set in the localStorage

npm init @svelteness/kit-docs mydocs

PS D:\Github\lancer-docs> npm init @svelteness/kit-docs mydocs

√ Default KitDocs Theme? (Y/n) · true

[kit-docs]: target directory is empty, creating new SvelteKit app.

PS D:\Github\lancer-docs>

Nothing happens, folder is empty.

Re-opening as a new issue (continuation of this PR) because I was unable to fix the Vite server repeatedly restarting. On top of that I can't release because of a bunch of TS issues as few things in SvelteKit are not playing nice with API Extractor.

This migration has been a huge pain and because of my super limited time it's hard to work through it. If anyone wants to have an attempt at fixing it there are some intstructions in linked PR above. The type issues can be seen if run npm run build.

I believe this is caused by breaking changes in Sveltekit. Is there a workaround?

See logs:

johngribbin@Johns-MacBook-Pro clams-tech % npm init @svelteness/kit-docs clams-docs

✔ Default KitDocs Theme? (Y/n) · true

[kit-docs]: target directory is empty, creating new SvelteKit app.


create-svelte version 2.0.0-next.158

Welcome to SvelteKit!

This is beta software; expect bugs and missing features.

Problems? Open an issue on https://github.com/sveltejs/kit/issues if none exists already.

✔ Which Svelte app template? › Skeleton project
✔ Add type checking with TypeScript? › Yes, using TypeScript syntax
✔ Add ESLint for code linting? … No / Yes
✔ Add Prettier for code formatting? … No / Yes
✔ Add Playwright for browser testing? … No / Yes

Your project is ready!
✔ Typescript
  Inside Svelte components, use <script lang="ts">
✔ ESLint
  https://github.com/sveltejs/eslint-plugin-svelte3
✔ Prettier
  https://prettier.io/docs/en/options.html
  https://github.com/sveltejs/prettier-plugin-svelte#options
✔ Playwright
  https://playwright.dev

Install community-maintained integrations:
  https://github.com/svelte-add/svelte-adders

Next steps:
  1: cd clams-docs
  2: npm install (or pnpm install, etc)
  3: git init && git add -A && git commit -m "Initial commit" (optional)
  4: npm run dev -- --open

To close the dev server, hit Ctrl-C

Stuck? Visit us at https://svelte.dev/chat

Error: ENOENT: no such file or directory, stat '/Users/johngribbin/Repos/clams-tech/clams-docs/src/routes/index.svelte'
    at Object.statSync (node:fs:1538:3)
    at __node_internal_ (node:internal/fs/utils:793:8)
    at rmSync (node:fs:1213:13)
    at main (file:///Users/johngribbin/.npm/_npx/cbc22df0399bae1c/node_modules/@svelteness/create-kit-docs/bin/create-kit-docs.js:58:11)
    at processTicksAndRejections (node:internal/process/task_queues:96:5) {
  errno: -2,
  syscall: 'stat',
  code: 'ENOENT',
  path: '/Users/johngribbin/Repos/clams-tech/clams-docs/src/routes/index.svelte'
}
npm ERR! code 1
npm ERR! path /Users/johngribbin/Repos/clams-tech
npm ERR! command failed
npm ERR! command sh -c -- create-kit-docs clams-docs

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/johngribbin/.npm/_logs/2022-08-24T10_33_49_230Z-debug-0.log

I noticed on your documentation site that if you scroll down a page, and then navigate to another page, it doesn't scroll back to the top op the page, meaning you have to manually scroll back up.

I'd experienced similar when using SvelteKit, as have others, as described in this issue.

However, the issue might be slightly different here, as it only seems to happen in Safari, and not Chrome.

Hello! First of all, I searched for a community or forum to ask this, but I did not find one. So, please excuse me if this is not the right place where to ask.

I need to add a blog and documentation to my website. Using kit-docs for both of them. The main idea is to set the links in the navbar, next to the other website pages. I could set both documentation and blog in the same website using different sources. The problems I have now are:

• I want to use only one navBar. I can't set the website navbar in the kit-docs pages. And I can't render a page in a different route using kit-docs navbar.
• I also need to do a different CSS for both blog and docs. I tried using different CSS imports for each [email protected] component. But the second page clicked overwrites the CSS variables of both pages. (if you click first blog and then docs, both pages use docs styles. And vice versa).

Here I leave the link of the repository. Steps to check:

1. Download this branch: https://gitlab.com/anagolay/blog/-/tree/1-build-blog-and-documentation-using-kitdocs
2. pnpm install
3. pnpm dev.
4. Open the URL displayed at the console and click docs, then blog, and then back to docs.
5. Go to home. Refresh. Click blog, then docs and then back to blog.

The question are:

• What is the best way to set different styling for both kit-docs pages?
• How can I render a single page below kit-docs navbar? or use website navbar for kit-docs pages? Thank you in advance!

I get this error

Error: The Serverless Function "." has invalid runtime: "nodejs18.x". Learn More: https://github.com/vercel/vercel/blob/main/DEVELOPING_A_RUNTIME.md#lambdaruntime