create-vasvibe 0.1.0

package/template/.opencode/skills/ui-ux-pro-max/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography, google-fonts
+Stacks: react, nextjs, vue, svelte, astro, swiftui, react-native, flutter, nuxtjs, nuxt-ui, html-tailwind, shadcn, jetpack-compose, threejs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help=f"Stack-specific search. Available: {', '.join(AVAILABLE_STACKS)}")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/template/GIT_STRUCTURE_GUIDE.md

@@ -0,0 +1,270 @@
+# Git Repository Structure Guide
+
+## 📁 Folder Structure Strategy
+
+Project ini menggunakan strategi **"empty folder tracking"** dengan `.gitkeep` files.
+
+### Concept:
+- Git tidak bisa track folder kosong
+- Solusi: Tambahkan file `.gitkeep` di folder yang ingin di-track
+- File lain di folder tersebut tetap di-ignore
+
+---
+
+## 🎯 Current Configuration
+
+### Folders with .gitkeep:
+
+```
+vas_vibe/
+├── codes/.gitkeep           ✅ Folder tracked, contents ignored
+├── specifications/.gitkeep  ✅ Folder tracked, contents ignored
+└── tests/.gitkeep          ✅ Folder tracked, contents ignored
+```
+
+### .gitignore Rules:
+
+```gitignore
+# Ignore all files in folder
+codes/*
+specifications/*
+tests/*
+
+# But keep .gitkeep files
+!codes/.gitkeep
+!specifications/.gitkeep
+!tests/.gitkeep
+```
+
+---
+
+## 🔍 How It Works
+
+### Pattern Explanation:
+
+1. **`codes/*`** - Ignore semua file di dalam folder `codes/`
+2. **`!codes/.gitkeep`** - Tapi **jangan** ignore file `.gitkeep`
+
+Simbol `!` adalah **negation pattern** yang membatalkan ignore rule sebelumnya.
+
+---
+
+## ✅ Verification
+
+### Check what gets tracked:
+
+```bash
+# See all tracked files
+git add .
+git status
+
+# Output should show:
+#   .gitignore
+#   codes/.gitkeep
+#   specifications/.gitkeep
+#   tests/.gitkeep
+#   README.md
+```
+
+### Check what gets ignored:
+
+```bash
+# See ignored files
+git status --ignored
+
+# Output should show:
+#   codes/ (all files except .gitkeep)
+#   specifications/ (all files except .gitkeep)
+#   tests/ (all files except .gitkeep)
+```
+
+---
+
+## 📊 Result
+
+### When someone clones the repository:
+
+```bash
+git clone <repository-url>
+cd vas_vibe
+ls -la
+```
+
+**They will get:**
+```
+vas_vibe/
+├── .gitignore              ✅ Present
+├── README.md               ✅ Present
+├── codes/                  ✅ Folder exists (empty except .gitkeep)
+│   └── .gitkeep            ✅ Present
+├── specifications/         ✅ Folder exists (empty except .gitkeep)
+│   └── .gitkeep            ✅ Present
+└── tests/                  ✅ Folder exists (empty except .gitkeep)
+    └── .gitkeep            ✅ Present
+```
+
+**They will NOT get:**
+- ❌ Files in `codes/` (except `.gitkeep`)
+- ❌ Files in `specifications/` (except `.gitkeep`)
+- ❌ Files in `tests/` (except `.gitkeep`)
+- ❌ `project_overview.md`
+- ❌ `development_log.md`
+
+---
+
+## 🎯 Use Cases
+
+### Scenario 1: Fresh Clone
+```bash
+git clone <repo>
+cd vas_vibe
+# Folders exist but are empty
+# Developer can start adding code to codes/ folder
+```
+
+### Scenario 2: Working with Code
+```bash
+cd codes
+npm install
+npm run dev
+# All development files stay local
+# .gitkeep ensures folder structure is preserved
+```
+
+### Scenario 3: Team Collaboration
+```bash
+# Each developer has:
+# - Same folder structure (thanks to .gitkeep)
+# - Own local code (not tracked)
+# - Shared documentation (README, etc.)
+```
+
+---
+
+## 💡 Advanced Patterns
+
+### If you want to track SOME files in codes:
+
+```gitignore
+# In .gitignore:
+codes/*
+!codes/.gitkeep
+!codes/important-config.json
+!codes/README.md
+```
+
+### If you want to track a subfolder:
+
+```gitignore
+# In .gitignore:
+codes/*
+!codes/.gitkeep
+!codes/shared/
+codes/shared/*
+!codes/shared/.gitkeep
+```
+
+---
+
+## 🔧 Common Commands
+
+### Add everything (respecting .gitignore):
+```bash
+git add .
+```
+
+### Check what will be committed:
+```bash
+git status
+```
+
+### See ignored files:
+```bash
+git status --ignored
+```
+
+### Force add an ignored file (if needed):
+```bash
+git add -f codes/special-file.ts
+```
+
+### Remove a file from tracking (keep local):
+```bash
+git rm --cached codes/some-file.ts
+```
+
+---
+
+## 📝 Benefits
+
+### ✅ Pros:
+1. **Folder structure preserved** - New developers get correct structure
+2. **No accidental commits** - Code stays local
+3. **Clean repository** - Only essential files tracked
+4. **Easy setup** - Clone and start coding
+5. **Flexible** - Can add exceptions with `!` pattern
+
+### ⚠️ Considerations:
+1. Must document which files go in which folder
+2. Developers need to know structure
+3. `.gitkeep` files add minimal overhead
+
+---
+
+## 🎓 Best Practices
+
+### DO:
+- ✅ Keep `.gitkeep` files simple (just a comment)
+- ✅ Document folder purpose in `.gitkeep`
+- ✅ Use consistent naming (`.gitkeep` is convention)
+- ✅ Add README.md in root to explain structure
+
+### DON'T:
+- ❌ Put important code in `.gitkeep`
+- ❌ Forget to add `!` negation in `.gitignore`
+- ❌ Delete `.gitkeep` files
+- ❌ Track both folder contents AND use `.gitkeep`
+
+---
+
+## 📚 References
+
+### Git Ignore Patterns:
+- `*` - Match all files
+- `!` - Negate previous pattern
+- `*/` - Match directories only
+- `**` - Match nested directories
+
+### Examples:
+```gitignore
+# Ignore all .log files
+*.log
+
+# But keep important.log
+!important.log
+
+# Ignore all in folder
+folder/*
+
+# But keep .gitkeep
+!folder/.gitkeep
+```
+
+---
+
+## ✅ Current Status
+
+```
+Repository Structure: ✅ Configured
+.gitkeep Files: ✅ Created (3 files)
+.gitignore Rules: ✅ Updated with negation
+Folder Tracking: ✅ Active
+Contents Ignored: ✅ Working
+```
+
+**Ready to commit and push!** 🚀
+
+---
+
+**Last Updated:** December 30, 2025  
+**Status:** ✅ Complete

package/template/PROJECT_README.example.md

@@ -0,0 +1,81 @@
+# Example Project README (VasVibe)
+
+> This file is shipped as a reference example by `create-vasvibe`. It shows
+> what a real project README built on top of this scaffold can look like.
+> You can safely delete this file or use it as a starting point for your own
+> `README.md`.
+
+---
+
+# 🚢 VasVibe - Platform Reservasi Kapal Wisata Labuan Bajo
+
+Platform reservasi online untuk jasa layanan pariwisata kapal di Labuan Bajo. Sistem lengkap dengan backoffice management dan customer booking platform.
+
+## 📋 Project Structure
+
+```
+vas_vibe/
+├── .gitignore              # Git ignore rules
+├── README.md               # This file
+├── project_overview.md     # Project overview & requirements
+├── codes/                  # Source code (ignored by git)
+│   ├── app/                # Next.js app directory
+│   ├── components/         # React components
+│   ├── lib/                # Utility functions & configs
+│   ├── prisma/             # Database schema & migrations
+│   ├── public/             # Static assets
+│   └── ...
+├── specifications/         # Technical specifications (ignored by git)
+│   ├── SPEC-000-*.md       # Environment setup
+│   ├── SPEC-001-*.md       # Database schema
+│   ├── SPEC-002-*.md       # Authentication system
+│   └── SPEC-003-*.md       # Booking management
+└── tests/                  # Test files
+```
+
+## 🎯 Key Features
+
+### Backoffice System
+- Dashboard, booking management, payment recording
+- Customer, ship, pricing management
+- Reports, audit logs, role-based access control
+
+### Customer Platform
+- Online booking, payment gateway, customer dashboard, e-tickets
+
+## 🛠️ Tech Stack
+
+- **Framework:** Next.js 15 (App Router)
+- **Language:** TypeScript
+- **Database:** PostgreSQL 16
+- **ORM:** Prisma
+- **Authentication:** NextAuth.js v5
+- **UI:** Tailwind CSS + Shadcn/UI
+- **Icons:** Lucide React
+- **Validation:** Zod
+- **Date Handling:** date-fns
+- **Excel Export:** xlsx
+- **Deployment:** Docker Compose
+
+## 🚀 Getting Started
+
+```bash
+# 1. Clone
+git clone <repository-url>
+cd {{projectName}}
+
+# 2. Setup code workspace
+cd codes
+npm install
+cp .env.example .env
+
+# 3. Start services
+docker compose up -d
+npx prisma migrate dev
+npm run prisma:seed
+npm run dev
+```
+
+---
+
+This file is illustrative only. See `README.md` for the actual project setup.

package/template/README.md

@@ -0,0 +1,52 @@
+# {{projectName}}
+
+Project ini di-scaffold dengan [`create-vasvibe`](https://www.npmjs.com/package/create-vasvibe), starter base yang sudah disiapkan dengan agent prompts (Claude, OpenCode, GitHub Copilot) dan struktur folder kerja standar tim.
+
+## Struktur folder
+
+```
+{{projectName}}/
+├── .agents/                # Skills bersama (developer, pm, find-skills, dll)
+├── .claude/                # Claude Code agents & skills
+├── .opencode/              # OpenCode commands & skills
+├── .github/prompts/        # GitHub Copilot prompt files
+├── agent/workflows/        # Workflow markdown agnostik tooling
+├── codes/                  # Source code (di-gitignore by default)
+├── specifications/         # Dokumen spek teknis (di-gitignore by default)
+├── tests/                  # Test files (di-gitignore by default)
+├── project_overview_example.md
+├── skills-lock.json
+├── GIT_STRUCTURE_GUIDE.md
+└── PROJECT_README.example.md
+```
+
+## Mulai
+
+1. **Konfigurasi AI provider untuk OpenCode** (opsional)
+
+   Buat `opencode.json` di root project sesuai panduan di https://opencode.ai/docs.
+
+2. **Mulai develop**
+
+   - Tulis `project_overview.md` di root (contoh tersedia di `project_overview_example.md`).
+   - Letakkan source code di `codes/`.
+   - Letakkan dokumen spek di `specifications/`.
+   - Letakkan test di `tests/`.
+
+3. **Pakai agent**
+
+   - Claude Code: agent tersedia di `.claude/agents/`.
+   - OpenCode: command tersedia di `.opencode/commands/`.
+   - GitHub Copilot: prompt files di `.github/prompts/`.
+
+## Catatan tracking git
+
+Folder `codes/`, `specifications/`, dan `tests/` di-track secara struktur (lewat `.gitkeep`) tetapi isinya di-`gitignore` by default. Lihat `GIT_STRUCTURE_GUIDE.md` untuk detailnya, atau ubah `.gitignore` sesuai kebutuhan project.
+
+## Contoh project nyata
+
+Lihat `PROJECT_README.example.md` untuk contoh README project nyata yang dibangun dengan starter ini (VasVibe).
+
+---
+
+Generated {{year}}.

package/template/_gitignore

@@ -0,0 +1,148 @@
+# {{projectName}} .gitignore
+# Generated by create-vasvibe
+
+# ==========================================
+# Project Folders to Ignore
+# ==========================================
+# Ignore all files in codes folder (development code)
+codes/*
+!codes/.gitkeep
+
+# Ignore all files in specifications folder (project specs)
+specifications/*
+!specifications/.gitkeep
+
+# Ignore all files in tests folder (test files)
+tests/*
+!tests/.gitkeep
+
+project_overview.md
+development_log.md
+.mcp.json
+opencode.json
+
+# ==========================================
+# OS Files
+# ==========================================
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Linux
+*~
+.directory
+
+# ==========================================
+# IDE & Editor Files
+# ==========================================
+# VS Code
+.vscode/
+*.code-workspace
+
+# JetBrains IDEs (WebStorm, IntelliJ, etc.)
+.idea/
+*.iml
+*.iws
+*.ipr
+
+# Sublime Text
+*.sublime-project
+*.sublime-workspace
+
+# Vim
+*.swp
+*.swo
+
+# Emacs
+\#*\#
+.\#*
+
+# ==========================================
+# Node.js
+# ==========================================
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# ==========================================
+# Frontend frameworks
+# ==========================================
+.next/
+out/
+build/
+dist/
+
+# ==========================================
+# Environment Variables
+# ==========================================
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env*.local
+
+# ==========================================
+# Database
+# ==========================================
+*.sqlite
+*.sqlite3
+*.db
+
+# Prisma
+prisma/migrations/
+!prisma/migrations/.gitkeep
+
+# ==========================================
+# Logs
+# ==========================================
+logs/
+*.log
+
+# ==========================================
+# Testing
+# ==========================================
+coverage/
+.nyc_output/
+*.lcov
+
+# ==========================================
+# Build & Cache
+# ==========================================
+.cache/
+.parcel-cache/
+.turbo/
+*.tsbuildinfo
+
+# ==========================================
+# Dependencies
+# ==========================================
+jspm_packages/
+
+# ==========================================
+# Miscellaneous
+# ==========================================
+.vercel
+.netlify
+.firebase/
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+temp/
+
+# OpenCode local artifacts
+.opencode/node_modules/
+.opencode/bun.lock