Merge branch 'main' into docs/update-comprehensive-readmes

Author: BunsDev

README.md

@@ -87,6 +87,15 @@ bun dev:desktop        # desktop shell + electron dev flow
 bun dev:marketing      # marketing site
 ```
 
+Build marketing directly:
+
+```bash
+bun install
+bun run build:marketing
+```
+
+If `bun run build:marketing` fails with `next: command not found`, run `bun install` first to restore workspace dependencies.
+
 ### Package scoped examples
 
 ```bash

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "private": true,
   "main": "dist-electron/main.js",
   "scripts": {

apps/marketing/README.md

@@ -0,0 +1,36 @@
+# Marketing App
+
+## Prerequisites
+
+- Install monorepo dependencies from the repo root before running marketing scripts:
+
+```bash
+bun install
+```
+
+## Build
+
+```bash
+bun run build:marketing
+```
+
+If the build fails with:
+
+```text
+/bin/bash: next: command not found
+```
+
+rerun:
+
+```bash
+bun install
+bun run build:marketing
+```
+
+This usually means the workspace dependencies were not yet installed for the current environment.
+
+If you see a build error about `CodeBlock.tsx` or `GetStarted.tsx` importing `useState`/`useEffect` in a Server Component:
+
+- You are likely running an older marketing checkout where those components still exist.
+- Switch to the current branch in this PR (`fix-marketing-build-errors`) and rerun install/build.
+- In that older snapshot, the fix is to add `"use client"` at the top of those client-only components.

apps/marketing/components/CodeBlock.tsx

@@ -1,3 +1,5 @@
+"use client";
+
 import { useState, useCallback, useRef, useEffect } from "react";
 
 const svgProps = {
@@ -31,7 +33,7 @@ interface CodeBlockProps {
 
 export function CodeBlock({ code, label }: CodeBlockProps) {
   const [copied, setCopied] = useState(false);
-  const timerRef = useRef<ReturnType<typeof setTimeout>>(null);
+  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   useEffect(() => {
     return () => {

apps/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okcodes",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "license": "MIT",
   "repository": {
     "type": "git",

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/web",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "private": true,
   "type": "module",
   "scripts": {

bun.lock

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/contracts",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "private": true,
   "files": [
     "dist"

packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "buildCommand": "cd apps/marketing && bun run build:marketing",
+  "buildCommand": "bun run build:marketing",
   "installCommand": "bun install",
   "outputDirectory": "apps/marketing/.next"
 }