⬆️ (doc): Migrate to Nextra v3

apps/docs/eslint.config.mjs

@@ -4,7 +4,7 @@ import globals from "globals";
 export default [
   ...baseConfig,
   {
-    ignores: [".next"],
+    ignores: [".next", "**/_meta.js"],
   },
   {
     languageOptions: {
@@ -15,7 +15,7 @@ export default [
   },
   {
     files: [
-      "next.config.js",
+      "next.config.mjs",
       "postcss.config.js",
       "tailwind.config.js",
       "theme.config.tsx",

apps/docs/next.config.mjs

@@ -0,0 +1,8 @@
+import nextra from "nextra";
+
+const withNextra = nextra({
+  theme: "nextra-theme-docs",
+  themeConfig: "./theme.config.tsx",
+});
+
+export default withNextra();

apps/docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ledgerhq/ledger-dmk-docs",
   "version": "1.0.0",
-  "description": "",
+  "description": "Device Management Kit documentation",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -17,16 +17,17 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "autoprefixer": "^10.4.17",
-    "next": "^14.1.0",
-    "nextra": "^2.13.3",
-    "nextra-theme-docs": "^2.13.3",
-    "postcss": "^8.4.35",
+    "next": "^14.2.15",
+    "nextra": "^3.0.13",
+    "nextra-theme-blog": "^3.0.13",
+    "nextra-theme-docs": "^3.0.15",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "tailwindcss": "^3.4.1"
+    "tailwindcss": "^3.4.16",
+    "tailwind-merge": "^1.14.0"
   },
   "devDependencies": {
+    "autoprefixer": "^10.4.17",
     "@ledgerhq/eslint-config-dsdk": "workspace:*",
     "@ledgerhq/prettier-config-dsdk": "workspace:*",
     "@ledgerhq/tsconfig-dsdk": "workspace:*",

apps/docs/pages/_meta.js

@@ -0,0 +1,13 @@
+export default {
+  index: {
+    title: "Home",
+    theme: {
+      layout: "raw",
+    },
+    display: "hidden",
+  },
+  docs: {
+    title: "Documentation",
+    type: "page",
+  },
+};

apps/docs/pages/docs/_meta.js

@@ -0,0 +1,8 @@
+export default {
+  docs: "Ledger Device Management Kits",
+  explanations: "Explanations",
+  beginners: "Beginner's guide",
+  integration_walkthroughs: "Integration Walkthrough",
+  migrations: "Migrations",
+  references: "References (TSDoc)",
+};

apps/docs/pages/docs/beginners/_meta.js

@@ -0,0 +1,6 @@
+export default {
+  setup: "Setup",
+  init_dmk: "Initialize Device Management Kit",
+  discover_and_connect: "Discover and connect",
+  exchange_data: "Exchange data with the device",
+};

apps/docs/pages/docs/explanations/_meta.js

@@ -0,0 +1,6 @@
+export default {
+  introduction: "Why the Device Management Kit?",
+  ledgerjs: "Differences with LedgerJS",
+  dmk: "Device Management Kit",
+  signers: "Signer kits",
+};

apps/docs/pages/docs/explanations/signers/_meta.js

@@ -0,0 +1,5 @@
+export default {
+  eth: "Signer Ethereum (EVM)",
+  solana: "Signer Solana",
+  btc: "Signer Bitcoin",
+};

apps/docs/pages/docs/integration_walkthroughs/_meta.js

@@ -0,0 +1,3 @@
+export default {
+  how_to: "How to ...",
+};

apps/docs/pages/docs/integration_walkthroughs/how_to/_meta.js

@@ -0,0 +1,4 @@
+export default {
+  how_to_use_a_signer: "use a Signer",
+  build_custom_command: "build a custom command",
+};

apps/docs/pages/docs/migrations/_meta.js

@@ -0,0 +1,3 @@
+export default {
+  "04_to_05": "DMK: Migrate from v0.4.0 to 0.5.0",
+};

apps/docs/tsconfig.eslint.json

@@ -4,7 +4,7 @@
     "**/*.ts",
     "**/*.tsx",
     ".next/types/**/*.ts",
-    "next.config.js",
+    "next.config.mjs",
     "postcss.config.js",
     "eslint.config.mjs",
     "tailwind.config.js"

apps/docs/tsconfig.json

@@ -12,7 +12,9 @@
     "next-env.d.ts",
     "**/*.ts",
     "**/*.tsx",
+    "**/*.js",
     "eslint.config.mjs",
+    "pages/_app.js",
     "tailwind.config.js"
   ],
   "exclude": ["node_modules"]

catalog-info.yml

@@ -14,7 +14,7 @@ metadata:
     github.com/project-slug: "LedgerHQ/device-sdk-ts"
     github.com/team-slug: "LedgerHQ/live-devices"
     ledger.com/code_repository: https://github.com/LedgerHQ/device-sdk-ts
-    ledger.com/documentation: https://developers.ledger.com/docs/device-interaction/integration/ldmk
+    ledger.com/documentation: https://developers.ledger.com/docs/device-interaction/getting-started
     jira/project-key: DSDK
   labels:
     ledger.com/contains_pii: "no"
@@ -41,7 +41,7 @@ spec:
   lifecycle: production
   owner: group:live-devices
   system: ledger-device-management-kit
-  subComponentOf: ts-device-management-kit
+  subComponentOf: device-management-kit-ts
 ---
 apiVersion: backstage.io/v1alpha1
 kind: Component
@@ -69,6 +69,23 @@ spec:
 ---
 apiVersion: backstage.io/v1alpha1
 kind: Component
+metadata:
+  name: ts-device-signer-kit-solana
+  description: Signer Kit for Solana
+  tags:
+    - typescript
+    - signer
+    - solana
+    - npm
+spec:
+  type: library
+  lifecycle: production
+  owner: group:live-devices
+  system: ledger-device-management-kit
+  subComponentOf: device-management-kit-ts
+---
+apiVersion: backstage.io/v1alpha1
+kind: Component
 metadata:
   name: ts-context-module
   description: Module for adding context to transactions
@@ -82,4 +99,4 @@ spec:
   lifecycle: production
   owner: group:live-devices
   system: ledger-device-management-kit
-  subComponentOf: ts-device-management-kit
+  subComponentOf: device-management-kit-ts