Merge branch 'main' into joan/order-from-config

Author: Nemikolh

.gitignore

@@ -20,4 +20,5 @@ dist-ssr
 .pnpm-store
 /tutorialkit/template
 tsconfig.tsbuildinfo
+tsconfig.build.tsbuildinfo
 .tmp

.prettierignore

@@ -1,2 +1,4 @@
 pnpm-lock.yaml
+.astro
 **/*.md
+**/*.mdx

docs/tutorialkit.dev/.gitignore

@@ -0,0 +1,6 @@
+# generated types
+.astro
+
+# environment variables
+.env
+.env.production

docs/tutorialkit.dev/README.md

@@ -0,0 +1,29 @@
+# [TutorialKit.dev](https://www.tutorialkit.dev)
+
+## Local Development
+
+### Prerequisites
+
+- Install [Node.js](https://nodejs.org/en) v18.18 or above.
+- Install [pnpm](https://pnpm.io/).
+
+### Set up
+
+Clone this repository and navigate into the cloned directory.
+
+```
+git clone [email protected]:stackblitz/tutorialkit.git
+cd tutorialkit
+```
+
+TutorialKit uses [pnpm workspaces](https://pnpm.io/workspaces). Just run the install command in the root of the project.
+
+```
+pnpm install
+```
+
+You can now start the documentation website by running:
+
+```
+pnpm run docs
+```

docs/tutorialkit.dev/astro.config.ts

@@ -0,0 +1,63 @@
+import { defineConfig } from 'astro/config';
+import react from '@astrojs/react';
+import starlight from '@astrojs/starlight';
+import starlightLinksValidator from 'starlight-links-validator';
+
+// https://astro.build/config
+export default defineConfig({
+  site: 'https://tutorialkit.dev',
+  integrations: [
+    react(),
+    starlight({
+      title: 'Create interactive coding tutorials',
+      components: {
+        Head: './src/components/Layout/Head.astro',
+      },
+      customCss: ['./src/styles/custom.scss'],
+      logo: {
+        dark: './src/assets/brand/tutorialkit-logo-dark.svg',
+        light: './src/assets/brand/tutorialkit-logo-light.svg',
+        replacesTitle: true,
+      },
+      plugins: [starlightLinksValidator()],
+      sidebar: [
+        {
+          label: 'Guides',
+          items: [
+            // Each item here is one entry in the navigation menu.
+            {
+              label: 'About',
+              link: '/guides/about/',
+            },
+            {
+              label: 'Installation',
+              link: '/guides/installation/',
+            },
+            {
+              label: 'Creating a Lesson',
+              link: '/guides/creating-content/',
+            },
+            {
+              label: 'Configuration',
+              link: '/guides/configuration/',
+            },
+            {
+              label: 'Deployment',
+              link: '/guides/deployment/',
+            },
+            {
+              label: 'User Interface Reference',
+              link: '/guides/ui/',
+            },
+          ],
+        },
+      ],
+      // social: {
+      // github: 'https://github.com/withastro/starlight',
+      // },
+      tableOfContents: {
+        maxHeadingLevel: 5,
+      },
+    }),
+  ],
+});

docs/tutorialkit.dev/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "tutorialkit.dev",
+  "type": "module",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro check && astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/check": "^0.7.0",
+    "@astrojs/react": "^3.4.0",
+    "@astrojs/starlight": "^0.23.2",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "astro": "^4.8.6",
+    "classnames": "^2.5.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "sass": "^1.77.3",
+    "sharp": "^0.32.5",
+    "starlight-links-validator": "^0.9.0",
+    "typescript": "^5.4.5"
+  },
+  "devDependencies": {
+    "@types/gtag.js": "^0.0.20"
+  }
+}