sidebars.js

/**
 * Creating a sidebar enables you to:
 - create an ordered group of docs
 - render a sidebar for each doc of that group
 - provide next/previous navigation

 The sidebars can be generated from the filesystem, or explicitly defined here.

 Create as many sidebars as you want.
 */

// @ts-check

/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
const sidebars = {
	// By default, Docusaurus generates a sidebar from the docs folder structure
	docs: [
		"overview/index",
		"what-is-ngrok",
		"how-ngrok-works",
		"why-ngrok",
		// These aren't ready yet
		// "install",
		// "core-concepts",
		{
			label: "Getting Started",
			type: "category",
			link: { type: "doc", id: "getting-started/index" },
			items: [
				"getting-started/index",
				"getting-started/go",
				"getting-started/rust",
			],
		},
		{
			type: "html",
			value: "<div class='menu__section'>Endpoints</div>",
		},
		{
			label: "HTTP",
			type: "category",
			link: { type: "doc", id: "http/index" },
			items: [{ type: "autogenerated", dirName: "http" }],
		},
		{
			label: "TLS",
			type: "category",
			link: { type: "doc", id: "tls/index" },
			items: [{ type: "autogenerated", dirName: "tls" }],
		},
		{
			label: "TCP",
			type: "category",
			link: { type: "doc", id: "tcp/index" },
			items: [{ type: "autogenerated", dirName: "tcp" }],
		},
		{
			type: "html",
			value: "<div class='menu__section'>Connectivity</div>",
		},
		{
			label: "Agent",
			type: "category",
			link: { type: "doc", id: "agent/index" },
			items: [
				"agent/index",
				"agent/web-inspection-interface",
				"agent/cli",
				"agent/config",
				"agent/api",
				"agent/ssh-reverse-tunnel-agent",
				"agent/ingress",
				"agent/changelog",
				"agent/version-support-policy",
			],
		},
		{
			label: "Agent SDKs",
			type: "category",
			link: { type: "doc", id: "agent-sdks/index" },
			items: [{ type: "autogenerated", dirName: "agent-sdks" }],
		},
		{
			label: "Kubernetes Controller",
			type: "category",
			link: { type: "doc", id: "k8s/index" },
			items: [{ type: "autogenerated", dirName: "k8s" }],
		},
		{
			type: "html",
			value: "<div class='menu__section'>Platform</div>",
		},
		{
			label: "Network Edge",
			type: "category",
			link: { type: "doc", id: "network-edge/index" },
			items: [
				"network-edge/index",
				"network-edge/domains-and-tcp-addresses",
				"network-edge/edges",
				"network-edge/gslb",
				"network-edge/tls-certificates",
				"network-edge/app-users",
			],
		},
		{
			label: "API",
			type: "category",
			link: { type: "doc", id: "api/index" },
			items: [
				"api/index",
				{
					type: "category",
					label: "API Reference",
					items: [
						"api/reference",
						// Abuse
						"api/resources/abuse-reports",
						// Agent
						{
							type: "category",
							label: "Agent",
							items: [
								"api/resources/agent-ingresses",
								"api/resources/tunnels",
								"api/resources/tunnel-sessions",
							],
						},
						// Application Users
						{
							type: "category",
							label: "Application Users",
							items: [
								"api/resources/application-users",
								"api/resources/application-sessions",
							],
						},
						// Backends
						{
							type: "category",
							label: "Backends",
							items: [
								"api/resources/failover-backends",
								"api/resources/http-response-backends",
								"api/resources/tunnel-group-backends",
								"api/resources/weighted-backends",
							],
						},
						// Certificates
						{
							type: "category",
							label: "Certificates",
							items: [
								"api/resources/certificate-authorities",
								"api/resources/ssh-certificate-authorities",
								"api/resources/ssh-host-certificates",
								"api/resources/ssh-user-certificates",
								"api/resources/tls-certificates",
							],
						},
						// Credentials
						{
							type: "category",
							label: "Credentials",
							items: [
								"api/resources/api-keys",
								"api/resources/ssh-credentials",
								"api/resources/credentials",
							],
						},
						// Endpoints
						{
							type: "category",
							label: "Endpoints",
							items: [
								"api/resources/reserved-addrs",
								"api/resources/reserved-domains",
								"api/resources/endpoints",
							],
						},
						// Events
						{
							type: "category",
							label: "Events",
							items: [
								"api/resources/event-destinations",
								"api/resources/event-sources",
								"api/resources/event-subscriptions",
							],
						},
						// HTTPS Edges
						{
							type: "category",
							label: "HTTPS Edges",
							items: [
								"api/resources/edges-https",
								"api/resources/edges-https-routes",
								"api/resources/https-edge-mutual-tls-module",
								"api/resources/https-edge-route-backend-module",
								"api/resources/https-edge-route-circuit-breaker-module",
								"api/resources/https-edge-route-compression-module",
								"api/resources/https-edge-route-ip-restriction-module",
								"api/resources/https-edge-route-oauth-module",
								"api/resources/https-edge-route-oidc-module",
								"api/resources/https-edge-route-request-headers-module",
								"api/resources/https-edge-route-response-headers-module",
								"api/resources/https-edge-route-saml-module",
								"api/resources/https-edge-route-webhook-validation-module",
								"api/resources/https-edge-route-websocket-tcp-converter-module",
								"api/resources/https-edge-tls-termination-module",
							],
						},
						// IP Restrictions
						{
							type: "category",
							label: "IP Restrictions",
							items: [
								"api/resources/ip-policies",
								"api/resources/ip-policy-rules",
								"api/resources/ip-restrictions",
							],
						},
						// TCP Edges
						{
							type: "category",
							label: "TCP Edges",
							items: [
								"api/resources/edges-tcp",
								"api/resources/tcp-edge-backend-module",
								"api/resources/tcp-edge-ip-restriction-module",
							],
						},
						// TLS Edges
						{
							type: "category",
							label: "TLS Edges",
							items: [
								"api/resources/edges-tls",
								"api/resources/tls-edge-backend-module",
								"api/resources/tls-edge-ip-restriction-module",
								"api/resources/tls-edge-mutual-tls-module",
								"api/resources/tls-edge-tls-termination-module",
							],
						},
					],
				},
			],
		},
		{
			label: "Observability",
			type: "category",
			link: { type: "doc", id: "obs/index" },
			items: ["obs/index", "obs/reference"],
		},
		{
			label: "IAM",
			type: "category",
			link: { type: "doc", id: "iam/index" },
			items: [
				"iam/index",
				"iam/users",
				"iam/bot-users",
				"iam/sso",
				"iam/rbac",
				"iam/domain-controls",
			],
		},
		{
			label: "Errors",
			type: "category",
			link: { type: "doc", id: "errors/index" },
			items: ["errors/index", "errors/reference"],
		},
		{
			type: "html",
			value: "<div class='menu__section'>Walkthroughs</div>",
		},
		{
			label: "Guides",
			type: "category",
			link: { type: "doc", id: "guides/index" },
			items: [
				{ type: "autogenerated", dirName: "guides" },
				{
					label: "Using ngrok with",
					type: "category",
					link: { type: "doc", id: "using-ngrok-with" },
					items: [{ type: "autogenerated", dirName: "using-ngrok-with" }],
				},
			],
		},
		{
			label: "Integrations",
			type: "category",
			link: { type: "doc", id: "integrations/index" },
			items: [{ type: "autogenerated", dirName: "integrations" }],
		},
		{
			type: "html",
			value: "<div class='menu__section'></div>",
		},
		"faq/faq",
	],
};

module.exports = sidebars;