Skillget

nuxt-supabase-starter

skill
Guvenlik Denetimi
Basarisiz
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 42 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in scripts/create-clean.sh
  • fs module — File system access in scripts/create-clean.sh
  • fs module — File system access in scripts/validate-starter.sh
  • Hardcoded secret — Potential hardcoded credential in scripts/validate-starter.sh
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This is a production-ready boilerplate template for developers to quickly spin up full-stack web applications using Nuxt 4, Vue, and Supabase. It includes pre-configured authentication, database policies, and AI-assisted development workflows.

Security Assessment
The overall risk is Medium. The scan flagged a few significant issues that require attention. First, a hardcoded credential was detected in a validation script (`scripts/validate-starter.sh`), which could be a secret or simply an example API key—this must be verified and removed before deploying. Second, the setup script (`scripts/create-clean.sh`) uses a recursive force deletion command (`rm -rf`) alongside active file system access. While common in boilerplate cleanup scripts to remove template files, `rm -rf` always carries inherent risks if paths are mishandled. Otherwise, the tool does not request dangerous system permissions, make mysterious network requests, or access sensitive user data.

Quality Assessment
The project is in excellent health and demonstrates strong maintenance practices. It received a very recent push (as of today), indicating active development. It uses the highly permissive and standard MIT license, making it safe for commercial and personal use. Community trust is solid for a specialized starter template, boasting 42 GitHub stars. The documentation is extensive, offering clear quick-start guides, deployment instructions, and visual aids.

Verdict
Use with caution — the template is well-maintained and highly functional, but developers must immediately audit the cleanup scripts and remove the hardcoded credential from the validation file before using it in a production environment.
SUMMARY

Nuxt + Supabase 快速開發範本，含 AI 輔助工作流程（Claude Code）、TDD、Spectra (OpenSpec)

README.md

Nuxt + Supabase Starter

License: MIT

Production-ready Nuxt 4 + Supabase starter template with Cookie-based auth, RLS, and spec-driven development.

這是什麼？

如果你已經熟悉 Nuxt，想要快速建立有後端、有資料庫、有認證、可部署的完整專案，這個範本能幫你在幾天內完成通常需要幾週的工作。

這不只是一個 boilerplate——它包含了實際中型企業系統的開發經驗：

  • 預設認證、CRUD、RLS、CI/CD、部署等完整流程
  • 與 Claude Code 協作的最佳實踐與工作流程
  • 踩過的坑、驗證過的模式、避免的反模式

目標讀者：有 Nuxt/Vue 經驗，想嘗試 Supabase 或想要一套可靠的全端開發工作流程的開發者。

快速開始

前置條件：Node.js 18+（建議 24 LTS）、pnpm、Docker、Supabase CLI

git clone https://github.com/YuDefine/nuxt-supabase-starter my-project
cd my-project
bash scripts/create-clean.sh
cd template
pnpm install
pnpm run setup    # 檢查環境 → 安裝依賴 → 啟動 Supabase → 產生型別
pnpm dev          # 開啟 http://localhost:3000

完整步驟：QUICK_START.md | 整合至現有專案：INTEGRATION_GUIDE.md

推薦使用方式：Clean 優先，Demo 選配

預設建議是先把專案切到乾淨開發起點，再開始做自己的功能；Demo 只在你需要快速看展示流程時使用。

# 目前在 my-project
bash scripts/create-clean.sh
cd template
pnpm dev
  • Clean 路徑：直接進入可持續開發骨架（推薦）
  • Demo 路徑：先看展示頁面，再切回 Clean

視覺路徑參考：VISUAL_GUIDE.md

費用與時間

開發時間

階段 時間 說明
Clone → 可運行 ~15 分鐘 pnpm run setup 一鍵完成
第一個功能 ~20 分鐘 跟著 FIRST_CRUD.md
部署上線 ~30 分鐘 跟著 DEPLOYMENT.md

月費估算

規模 Supabase Cloudflare 總計
開發 / MVP 免費 免費 $0
小型產品 Pro $25 $5 ~$30/月
成長期 Pro $25+ $5+ ~$100+/月

免費方案包含：500MB 資料庫、5GB 頻寬、10 萬次 Workers 請求/天。對大多數 MVP 足夠。

Supabase 是開源的，可以免費 Self-host 在自己的伺服器上，不受 Cloud 免費方案限制。

Tech Stack

Nuxt 4 + Vue 3 + TypeScript + Supabase + Nuxt UI + Tailwind CSS + Pinia + Better Auth

類別 技術
框架 Nuxt 4, Vue 3, TypeScript
資料庫 Supabase (PostgreSQL)
UI Nuxt UI, Tailwind CSS, Nuxt Charts
認證 Better Auth (33+ OAuth providers)
狀態 Pinia + Pinia Colada
測試 Vite+ (Vitest) + Playwright
部署 Cloudflare Workers
品質 Vite+ (OXLint + OXFmt + Hooks)

完整技術棧與選型理由：TECH_STACK.md

專案結構

├── template/                         # Nuxt + Supabase starter template
│   ├── app/                          # Frontend (pages, components, composables)
│   ├── server/                       # Backend (API, utils, plugins)
│   ├── supabase/                     # Database (migrations, seed, config)
│   ├── packages/create-nuxt-starter/ # CLI scaffolding tool
│   ├── docs/                         # 開發知識文件
│   └── .claude/                      # Claude Code 配置
├── docs/                             # Starter 展示文件
├── scripts/                          # Meta 維護腳本
├── README.md
├── CLAUDE.md
└── LICENSE

文件導覽

不知道從哪開始？ 參考 文件導讀指南。

我想要... 閱讀這份
新專案快速開始 QUICK_START.md
現有專案整合配置 INTEGRATION_GUIDE.md
了解開發流程 WORKFLOW.md
查詢常見問題 FAQ.md
了解 AI 配置 CLAUDE_CODE_GUIDE.md
查閱系統狀態 docs/verify/
完整文件清單

Starter 展示文件（docs/）

文件 說明
QUICK_START.md 新專案安裝與設定步驟
INTEGRATION_GUIDE.md 現有專案整合 Claude/Supabase
FIRST_CRUD.md 第一個 CRUD 功能教學
VISUAL_GUIDE.md 視覺化系統導覽
READING_GUIDE.md 文件分類與閱讀順序
SKILL_UPDATE_GUIDE.md Skills 更新指南
CLAUDE_CODE_GUIDE.md Claude Code 配置指南

開發知識文件（template/docs/）

文件 說明
WORKFLOW.md TDD、自動化檢查、Git 規範
FAQ.md 常見疑問集
DEPLOYMENT.md 部署指南
TECH_STACK.md 技術棧與選型理由
SUPABASE_GUIDE.md Supabase 入門與 RLS 詳解
API_PATTERNS.md Server API 設計模式
OPENSPEC.md Spectra 工作流程詳解

CLI Tool

create-nuxt-starter 目前以 repo 內執行為主：

pnpm --filter create-nuxt-starter dev -- /path/to/my-app --yes

詳細說明請看 CLI_SCAFFOLD.md

常見問題

Q: 我需要付費嗎？ 本地開發完全免費。Supabase 免費方案：500MB 資料庫、50K 月活躍使用者。

Q: 我可以不用 Claude Code 嗎？ 可以。.claude/ 配置是可選的，核心的 Nuxt + Supabase 結構不依賴任何 AI 工具。

Q: 如何部署到 Production？ 在 Supabase Dashboard 建立專案 → supabase link → supabase db push → 部署到 Cloudflare Workers。

更多問題：FAQ.md

下一步

新專案

  1. 快速開始：clone、跑起來
  2. Supabase 入門：建立第一個資料表
  3. API 設計：寫你的第一個 CRUD API
  4. Spectra：用 AI 輔助開發一個功能
  5. 部署指南：部署到 Cloudflare Workers

現有專案

  1. 整合指南：將 Claude/Supabase 配置注入現有專案
  2. 根據需要選擇整合項目（Claude 配置、Supabase、Better Auth）

有問題歡迎開 issue。

License

MIT © YuDefine - 域定資訊工作室

Yorumlar (0)

Sonuc bulunamadi