ikanban-web 0.2.5 → 0.2.7

package/README.md

@@ -1,34 +1,39 @@
-## Usage
+# ikanban
 
-Dependencies for these templates are managed with [pnpm](https://pnpm.io) using `pnpm up -Lri`.
+iKanban is a Web interface for the [OpenCode](https://opencode.ai) AI coding agent. It unifies chat, terminal, and board workflows in a single interface so teams can plan, execute, and track coding tasks.
 
-This is the reason you see a `pnpm-lock.yaml`. That said, any package manager will work. This file can safely be removed once you clone a template.
+## UI Previews
 
-```bash
-$ npm install # or pnpm install or yarn install
-```
+<details>
+<summary>Expand screenshots</summary>
 
-### Learn more on the [Solid Website](https://solidjs.com) and come chat with us on our [Discord](https://discord.com/invite/solidjs)
+<img width="3695" height="2149" alt="Image" src="https://github.com/user-attachments/assets/b5ca21b8-b8aa-46f6-84cc-8906f629b6c8" />
 
-## Available Scripts
+</details>
 
-In the project directory, you can run:
+## Quick Start
 
-### `npm run dev` or `npm start`
+### Option 1: Use the hosted app (recommended)
 
-Runs the app in the development mode.<br>
-Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
+Open: https://isomoes.github.io/ikanban
 
-The page will reload if you make edits.<br>
+Start OpenCode with CORS enabled for GitHub Pages:
 
-### `npm run build`
+```bash
+opencode serve --port <PORT> --cors https://isomoes.github.io
+```
 
-Builds the app for production to the `dist` folder.<br>
-It correctly bundles Solid in production mode and optimizes the build for the best performance.
+Then add your server URL in settings: `http://localhost:<PORT>`.
 
-The build is minified and the filenames include the hashes.<br>
-Your app is ready to be deployed!
+### Option 2: Run locally with npx
+
+```bash
+npx ikanban-web@latest                        # Start on port 3000
+npx ikanban-web@latest --port 8080            # Custom port
+OPENCODE_URL=http://myserver:4096 npx ikanban-web@latest  # External OpenCode server
+```
 
-## Deployment
+## Acknowledgments
 
-You can deploy the `dist` folder to any static host provider (netlify, surge, now, etc.)
+- Inspired by and thanks to the [openchamber](https://github.com/btriapitsyn/openchamber) project.
+- [opencode web UI](https://github.com/anomalyco/opencode/tree/dev/packages/app)

package/bin/cli.js

@@ -30,8 +30,9 @@ const PORT = portFlag !== -1 ? parseInt(args[portFlag + 1], 10) : 3000
 // OpenCode backend: honour OPENCODE_URL or default to localhost:4096
 const OPENCODE_URL = process.env.OPENCODE_URL || "http://localhost:4096"
 
-function proxyRequest(req, res) {
+function proxyRequest(req, res, overridePath) {
   const target = new URL(req.url, OPENCODE_URL)
+  if (overridePath !== undefined) target.pathname = overridePath
   const mod = target.protocol === "https:" ? https : http
   const options = {
     hostname: target.hostname,
@@ -51,9 +52,18 @@ function proxyRequest(req, res) {
   req.pipe(proxy)
 }
 
+const BASE = "/ikanban"
+
 const server = http.createServer((req, res) => {
   const url = new URL(req.url, `http://localhost:${PORT}`)
 
+  // Redirect bare /ikanban to /ikanban/
+  if (url.pathname === BASE) {
+    res.writeHead(301, { Location: BASE + "/" })
+    res.end()
+    return
+  }
+
   // Proxy OpenCode API paths to backend.
   // These are the top-level path segments used by @opencode-ai/sdk.
   const API_PREFIXES = [
@@ -82,15 +92,37 @@ const server = http.createServer((req, res) => {
     "/tui",
     "/vcs",
   ]
+  // Support both /session/... (SDK default, same-origin) and
+  // /ikanban/session/... (prefixed, e.g. from a reverse proxy).
+  // Determine the effective API pathname by stripping the base prefix if present.
+  let apiPathname = url.pathname
+  if (apiPathname.startsWith(BASE + "/")) {
+    const stripped = apiPathname.slice(BASE.length)
+    if (API_PREFIXES.some((p) => stripped === p || stripped.startsWith(p + "/"))) {
+      apiPathname = stripped
+    }
+  }
   const isApi = API_PREFIXES.some(
-    (p) => url.pathname === p || url.pathname.startsWith(p + "/"),
+    (p) => apiPathname === p || apiPathname.startsWith(p + "/"),
   )
   if (isApi) {
-    return proxyRequest(req, res)
+    // Pass the stripped path so the backend never sees the /ikanban prefix
+    return proxyRequest(req, res, apiPathname !== url.pathname ? apiPathname : undefined)
+  }
+
+  // Strip /ikanban prefix before resolving static files
+  let pathname = url.pathname
+  if (pathname.startsWith(BASE + "/")) {
+    pathname = pathname.slice(BASE.length) || "/"
+  } else if (pathname !== BASE) {
+    // Anything outside /ikanban/ that isn't an API call gets a 404
+    res.writeHead(404)
+    res.end("Not found")
+    return
   }
 
   // Serve static files from dist/
-  let filePath = path.join(DIST, url.pathname)
+  let filePath = path.join(DIST, pathname)
   if (!fs.existsSync(filePath) || fs.statSync(filePath).isDirectory()) {
     filePath = path.join(DIST, "index.html")
   }
@@ -110,7 +142,7 @@ const server = http.createServer((req, res) => {
 })
 
 server.listen(PORT, () => {
-  console.log(`iKanban running at http://localhost:${PORT}`)
+  console.log(`iKanban running at http://localhost:${PORT}${BASE}/`)
   console.log(`OpenCode backend: ${OPENCODE_URL}`)
   console.log("Press Ctrl+C to stop")
 })