Merge pull request #6 from cupcakearmy/dependabot/npm_and_yarn/next-14.2.32

Bump next from 14.2.30 to 14.2.32

.github/actions/build/action.yaml

@@ -1,17 +0,0 @@
-name: "Build"
-description: "Install deps and build docs"
-
-runs:
-  using: "composite"
-  steps:
-    - uses: pnpm/action-setup@v2
-    - uses: actions/setup-node@v3
-      with:
-        node-version-file: .nvmrc
-        cache: "pnpm"
-    - name: Install dependencies
-      run: pnpm install --frozen-lockfile
-      shell: bash
-    - name: Build
-      run: pnpm build
-      shell: bash

.github/workflows/preview.yaml

@@ -1,35 +0,0 @@
-name: Docs
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: true
-
-jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - uses: ./.github/actions/build
-
-      - uses: actions/configure-pages@v3
-      - uses: actions/upload-pages-artifact@v1
-        with:
-          path: "./out"
-      - id: deployment
-        uses: actions/deploy-pages@v1

.nvmrc

@@ -1 +1 @@
-v18.16.0
+v22.13.0

next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.

next.config.js

@@ -1,11 +1,13 @@
-const withNextra = require('nextra')({
+import nextra from 'nextra'
+
+const withNextra = nextra({
   theme: 'nextra-theme-docs',
   themeConfig: './theme.config.jsx',
 })
 
-module.exports = {
+export default withNextra({
-  ...withNextra(),
+  output: 'export',
   images: {
     unoptimized: true,
   },
-}
+})

package.json

@@ -1,16 +1,21 @@
 {
   "private": true,
   "license": "MIT",
-  "packageManager": "pnpm@8.6.0",
+  "type": "module",
   "scripts": {
-    "dev": "next dev",
+    "build": "NEXT_TELEMETRY_DISABLED=1 next build",
-    "build": "next build && next export"
+    "dev": "NEXT_TELEMETRY_DISABLED=1 next dev",
+    "start": "pnpm dlx serve out"
   },
   "dependencies": {
-    "next": "^13.4.4",
+    "next": "^14.2.32",
-    "nextra": "^2.6.2",
+    "nextra": "^3.0.15",
-    "nextra-theme-docs": "^2.6.2",
+    "nextra-theme-docs": "^3.0.15",
-    "react": "^18.2.0",
+    "react": "^18.3.1",
-    "react-dom": "^18.2.0"
+    "react-dom": "^18.3.1"
-  }
+  },
+  "devDependencies": {
+    "@types/node": "22.7.7"
+  },
+  "packageManager": "pnpm@9.12.2"
 }

pages/_app.mdx

@@ -1,3 +0,0 @@
-export default function App({ Component, pageProps }) {
-  return <Component {...pageProps} />
-}

pages/_meta.json

@@ -1,7 +0,0 @@
-{
-  "index": "Intro",
-  "cli": "CLI",
-  "git": "Git",
-  "dev_ops": "Dev Ops",
-  "latex": "LaTeX"
-}

pages/_meta.ts

@@ -0,0 +1,8 @@
+export default {
+  index: 'Intro',
+  cli: 'CLI',
+  git: 'Git',
+  dev_ops: 'Dev Ops',
+  latex: 'LaTeX',
+  web_dev: 'Web Development',
+}

pages/admin/windows.md

@@ -0,0 +1,21 @@
+---
+tags:
+  - windows
+  - administration
+---
+
+# Windows
+
+
+## List of tools
+
+- [De-Bloat](https://github.com/Raphire/Win11Debloat)
+- [Microsoft Activation Scripts](https://github.com/massgravel/Microsoft-Activation-Scripts)
+- [Uniget UI](https://github.com/marticliment/UnigetUI)
+
+
+## Utils
+
+### Add local user
+
+`Win + R` then `netplwiz`

pages/cli/delete-empty-directories.md

@@ -0,0 +1,7 @@
+# Delete empty directories
+
+```bash
+find . -type d -empty -delete
+```
+
+This recursively finds and deletes empty directory.

pages/cli/format-drive.md

@@ -0,0 +1,23 @@
+---
+tags:
+  - cli
+  - macos
+  - format
+---
+
+# Format a Drive
+
+## macOS
+
+Some times Disk Utility cannot format a whole drive for some reason.
+
+```
+# Check devices
+diskutil list
+
+# To exfat
+diskutil eraseDisk EXFAT "NAME" GPT /dev/diskN
+
+# To fat32, with mbr
+ diskutil eraseDisk FAT32 "NAME" MBR /dev/diskN
+```

pages/dev_ops/_meta.json

@@ -1,4 +0,0 @@
-{
-  "github-actions": "Github Actions",
-  "hosting": "Hosting"
-}

pages/dev_ops/_meta.ts

@@ -0,0 +1,4 @@
+export default {
+  'github-actions': 'Github Actions',
+  hosting: 'Hosting',
+}

pages/dev_ops/github-actions/publish-docker-images.md

@@ -22,15 +22,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         with:
           install: true
 
       - name: Docker Labels
         id: meta
-        uses: docker/metadata-action@v4
+        uses: docker/metadata-action@v5
         with:
           images: |
             foo/bar
@@ -43,19 +43,19 @@ jobs:
             type=semver,pattern={{major}}
 
       - name: Log in to Docker Hub
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_TOKEN }}
       - name: Log in to the Container registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           platforms: linux/amd64,linux/arm64
           push: true

pages/dev_ops/hosting/docker-registry.md

@@ -0,0 +1,14 @@
+---
+tags:
+  - docker registry
+  - hosting
+  - authentication
+---
+
+# Setup you own authenticated Docker Registry
+
+## Resources
+
+- https://earthly.dev/blog/private-docker-registry/
+- https://www.digitalocean.com/community/tutorials/how-to-set-up-a-private-docker-registry-on-ubuntu-20-04
+- https://github.com/docker/get-involved/blob/90c9470fd66c9318fec9c6f0914cb70fa87b9bf9/content/en/docs/CommunityLeaders/EventHandbooks/Docker101/registry/_index.md?plain=1#L203

pages/git/clean.md

@@ -0,0 +1,17 @@
+---
+tags:
+  - git
+  - clean
+  - gitignore
+  - delete
+---
+
+# Delete all files mentioned by `.gitignore`
+
+This command is useful if you want to reset a repository to it's checked out state.
+
+```bash
+git clean -Xdf
+```
+
+[Original SO Link](https://unix.stackexchange.com/a/542735)

pages/git/remove-merged-branch.md

@@ -0,0 +1,20 @@
+---
+tags:
+  - git
+  - branch
+  - clean
+  - delete
+---
+
+# Delete all local branches that are already merged.
+
+This command is useful if you have a buch of local branches that you don't need anymore.
+
+```bash
+git branch --merged | grep -v \* | xargs git branch -D
+```
+
+[Original SO Link](https://stackoverflow.com/a/10610669)
+
+
+ 

pages/git/remove-secrets.md

@@ -0,0 +1,9 @@
+# Remove secrets after being pushed
+
+If you accidentally pushed a secret or some file that should not be publicly available in your git repo, there are a few ways. My personal fav is [BFG](https://rtyley.github.io/bfg-repo-cleaner/).
+
+> `--no-blob-protection` also modifies you latest commit, by default that is turned off.
+
+```bash
+bfg -D "*.txt" --no-blob-protection
+```

pages/git/reset-files.md

@@ -3,5 +3,9 @@
 How to reset files from another branch.
 
 ```sh
+# New way
+git restore my/file.md
+
+# Old way
 git checkout origin/HEAD -- my/file.md
 ```

pages/git/revert-commit.md

@@ -0,0 +1,16 @@
+# Revert branch to commit
+
+Revert a branch to a certain commit, discarding newer ones.
+
+```bash
+# Specific commit
+git reset --hard a1d6424
+
+# Commits back
+git reset --hard HEAD@{3}
+```
+
+```bash
+# Push
+git push -f
+```

pages/web_dev/tailwind_theme.md

@@ -0,0 +1,82 @@
+---
+tags:
+  - tailwind
+  - theme
+  - css variables
+  - dark mode
+---
+
+# Tailwind themes with CSS Variables
+
+There are many tailwind theme plugins, tried few and landed on`tailwindcss-themer`.
+
+## Setup
+
+Two files are required:
+
+1. `pnpm i -D tailwindcss-themer`
+1. `tailwind.config.js`
+1. `app.postcss`
+
+> Technically, we don't need to use CSS variables, but I like to, as I can export them automatically from Figma, or whatever design tool. Without CSS Variables, you could just define the colors in `tailwind.config.js` without touching css files.
+
+```js
+// tailwind.config.js
+
+const themer = require('tailwindcss-themer')
+
+/** @type {import('tailwindcss').Config}*/
+const config = {
+  theme: {
+    // ...
+  },
+
+  plugins: [
+    themer({
+      defaultTheme: {
+        extend: {
+          colors: {
+            primary: 'var(--colors-cyan-500)',
+            secondary: 'var(--colors-yellow-500)',
+            surface: 'var(--colors-gray-100)',
+            text: 'var(--colors-gray-900)',
+          },
+        },
+      },
+      themes: [
+        {
+          name: 'darker',
+          mediaQuery: '@media (prefers-color-scheme: dark)',
+          extend: {
+            colors: {
+              primary: 'var(--colors-cyan-700)',
+              secondary: 'var(--colors-yellow-500)',
+              surface: 'var(--colors-gray-900)',
+              text: 'var(--colors-gray-100)',
+            },
+          },
+        },
+      ],
+    }),
+  ],
+}
+
+module.exports = config
+```
+
+```css
+/* app.postcss */
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  /* colors */
+  --colors-cyan-500: rgb(164, 189, 245);
+  --colors-cyan-700: #0d398c;
+  --colors-gray-100: rgb(255, 255, 255);
+  --colors-gray-900: rgb(1, 1, 1);
+  --colors-yellow-500: rgb(233, 246, 82);
+}
+```

theme.config.jsx

@@ -10,6 +10,9 @@ export default {
   feedback: {
     content: 'Question? An error? Give feedback →',
   },
+  head: (
+    <script defer src="https://spectare.nicco.io//unicorn.js" data-website-id="4aecaa6f-1e68-4a21-960a-8ff5aaa6599a"></script>
+  ),
   footer: {
     text: (
       <span>

tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "noEmit": true,
+    "incremental": true,
+    "module": "esnext",
+    "esModuleInterop": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve"
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}