nirholas · netpoe · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026
@@ -0,0 +1,111 @@
+---
+description: Use Bun instead of Node.js, npm, pnpm, or vite.
+globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
+alwaysApply: false
+---
+
+Default to using Bun instead of Node.js.
+
+- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
+- Use `bun test` instead of `jest` or `vitest`
+- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
+- Use `bunx <package> <command>` instead of `npx <package> <command>`
+- Bun automatically loads .env, so don't use dotenv.
+
+## APIs
+
+- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
+- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
+- `Bun.redis` for Redis. Don't use `ioredis`.
+- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
+- `WebSocket` is built-in. Don't use `ws`.
+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
+- Bun.$`ls` instead of execa.
+
+## Testing
+
+Use `bun test` to run tests.
+
+```ts#index.test.ts
+import { test, expect } from "bun:test";
+
+test("hello world", () => {
+  expect(1).toBe(1);
+});
+```
+
+## Frontend
+
+Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
+
+Server:
+
+```ts#index.ts
+import index from "./index.html"
+
+Bun.serve({
+  routes: {
+    "/": index,
+    "/api/users/:id": {
+      GET: (req) => {
+        return new Response(JSON.stringify({ id: req.params.id }));
+      },
+    },
+  },
+  // optional websocket support
+  websocket: {
+    open: (ws) => {
+      ws.send("Hello, world!");
+    },
+    message: (ws, message) => {
+      ws.send(message);
+    },
+    close: (ws) => {
+      // handle close
+    }
+  },
+  development: {
+    hmr: true,
+    console: true,
+  }
+})
+```
+
+HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
+
+```html#index.html
+<html>
+  <body>
+    <h1>Hello, world!</h1>
+    <script type="module" src="./frontend.tsx"></script>
+  </body>
+</html>
+```
+
+With the following `frontend.tsx`:
+
+```tsx#frontend.tsx
+import React from "react";
+import { createRoot } from "react-dom/client";
+
+// import .css files directly and it works
+import './index.css';
+
+const root = createRoot(document.body);
+
+export default function Frontend() {
+  return <h1>Hello, world!</h1>;
+}
+
+root.render(<Frontend />);
+```
+
+Then, run index.ts
+
+```sh
+bun --hot ./index.ts
+```
+
+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.
@@ -1,141 +1,142 @@
-# Gitignore for Universal Crypto MCP
-################################################################
-
-# System files
-.DS_Store
-Thumbs.db
-ehthumbs.db
-Desktop.ini
-
-# Linux/Ubuntu system files
-*~
-*.swp
-*.swo
-.fuse_hidden*
-.directory
-.Trash-*
-.nfs*
-.gvfs-fuse-daemon-*
-
-# IDE and editors
-.idea/
-*.sublime-*
-.history/
-.windsurfrules
-*.code-workspace
-.vscode/sessions.json
-
-# Temporary files
-.temp/
-temp/
-tmp/
-*.tmp
-*.temp
-*.log
-*.cache
-.cache/
-
-# Environment files
-.env
-.env.local
-.env*.local
-.env.development
-venv/
-.venv/
-.env.example.development
-.env.example
-.env.desktop
-.env*
-.env.sentry-build-plugin
-
-# Dependencies
-node_modules/
-*.lock
-package-lock.json
-bun.lockb
-.pnpm-store/
-/.pnp
-.pnp.js
-
-# Build outputs
-dist/
-es/
-/lib/
-.next/
-/out/
-/build
-logs/
-test-output/
-*.tsbuildinfo
-next-env.d.ts
-
-# Framework specific
-# Umi
-.umi/
-.umi-production/
-.umi-test/
-.dumi/tmp*/
-
-# Vercel
-.vercel/
-
-# Testing and CI
-coverage/
-.coverage/
-.nyc_output/
-.eslintcache
-.stylelintcache
-
-# Database
-/prisma/db.sqlite
-/prisma/db.sqlite-journal
-db.sqlite
-
-# Debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# Misc
-*.pem
-src/tools/binance-spot/a.sh
-a.sh
-src/tools/binance-spot/a.txt
-
-# Service Worker / Serwist
-public/sw*
-public/swe-worker*
-
-# Generated files
-public/*.js
-public/sitemap.xml
-public/sitemap-index.xml
-sitemap*.xml
-robots.txt
-
-# Git hooks
-.husky/prepare-commit-msg
-
-# Documents and media
-*.patch
-*.pdf
-*.ppt*
-*.doc*
-*.xls*
-
-# Cloud service keys
-vertex-ai-key.json
-
-# AI coding tools
-.local/
-.claude/
-.mcp.json
-CLAUDE.local.md
-.serena/**
-
-# Misc
-./packages/lobe-ui
-prd
-GEMINI.md
-e2e/reports
+# Gitignore for Universal Crypto MCP
+################################################################
+
+# System files
+.DS_Store
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Linux/Ubuntu system files
+*~
+*.swp
+*.swo
+.fuse_hidden*
+.directory
+.Trash-*
+.nfs*
+.gvfs-fuse-daemon-*
+
+# IDE and editors
+.idea/
+*.sublime-*
+.history/
+.windsurfrules
+*.code-workspace
+.vscode/sessions.json
+
+# Temporary files
+.temp/
+temp/
+tmp/
+*.tmp
+*.temp
+*.log
+*.cache
+.cache/
+
+# Environment files
+.env
+.env.local
+.env*.local
+.env.development
+venv/
+.venv/
+.env.example.development
+.env.example
+.env.desktop
+.env*
+.env.sentry-build-plugin
+config.json
+
+# Dependencies
+node_modules/
+*.lock
+package-lock.json
+bun.lockb
+.pnpm-store/
+/.pnp
+.pnp.js
+
+# Build outputs
+dist/
+es/
+/lib/
+.next/
+/out/
+/build
+logs/
+test-output/
+*.tsbuildinfo
+next-env.d.ts
+
+# Framework specific
+# Umi
+.umi/
+.umi-production/
+.umi-test/
+.dumi/tmp*/
+
+# Vercel
+.vercel/
+
+# Testing and CI
+coverage/
+.coverage/
+.nyc_output/
+.eslintcache
+.stylelintcache
+
+# Database
+/prisma/db.sqlite
+/prisma/db.sqlite-journal
+db.sqlite
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Misc
+*.pem
+src/tools/binance-spot/a.sh
+a.sh
+src/tools/binance-spot/a.txt
+
+# Service Worker / Serwist
+public/sw*
+public/swe-worker*
+
+# Generated files
+public/*.js
+public/sitemap.xml
+public/sitemap-index.xml
+sitemap*.xml
+robots.txt
+
+# Git hooks
+.husky/prepare-commit-msg
+
+# Documents and media
+*.patch
+*.pdf
+*.ppt*
+*.doc*
+*.xls*
+
+# Cloud service keys
+vertex-ai-key.json
+
+# AI coding tools
+.local/
+.claude/
+.mcp.json
+CLAUDE.local.md
+.serena/**
+
+# Misc
+./packages/lobe-ui
+prd
+GEMINI.md
+e2e/reports