sui-full-stack

name

sui-full-stack

description

Use when starting a new SUI project from scratch or need end-to-end workflow orchestration (architecture → contracts → frontend → testing → deployment). This is the PROJECT ORCHESTRATOR that routes to specialized skills per phase. Triggers on "new project", "start from scratch", "full workflow", "what's the next step", or any multi-phase SUI development task. Do NOT use for Move↔TypeScript integration tasks (type generation, event handling) — that's sui-move-ts-bridge.

SUI Full-Stack Development

Complete end-to-end SUI Move project development workflow.

Overview

This is the main orchestrator skill that guides you through the entire SUI development lifecycle:

1. Phase 0: Project Initialization & Git Setup
2. Phase 1: Architecture Planning (sui-architect)
3. Phase 2: Smart Contract Development (sui-developer)
4. Phase 3: Frontend Development (sui-frontend) - Optional
5. Phase 4: Integration (sui-move-ts-bridge)
6. Phase 5: Testing (sui-tester)
7. Phase 6: Deployment (sui-deployer)
8. Phase 7: Documentation Generation - Optional

Quick Start

# Start new project
sui-full-stack

# Resume existing project
sui-full-stack --resume

# Skip to specific stage
sui-full-stack --stage testing

Workflow Summary

Phase 0: Project Initialization

• Collect project name and description
• Set up Git version control (optional GitHub sync)
• Create .gitignore, pre-commit hooks via sui-security-guard

Phase 1: Architecture Planning

• Call sui-architect for guided Q&A
• Generate specification document and architecture diagrams
• Git checkpoint with architecture commit

Phase 2: Smart Contract Development

• Call sui-developer to generate Move code from spec
• Real-time quality checks (fast/standard/strict modes)
• Auto-generate TypeScript types
• Git checkpoint with contracts commit

Phase 3: Frontend Development (Optional)

• Call sui-frontend to set up React/Next.js/Vue
• Install @mysten/dapp-kit-react @mysten/dapp-kit-core @mysten/sui @tanstack/react-query (hooks/providers from @mysten/dapp-kit-react; UI components like ConnectButton from @mysten/dapp-kit-react/ui). The legacy @mysten/dapp-kit package is deprecated.
• Wallet integration and API wrappers
• Git checkpoint with frontend commit

Phase 4: Integration

• Call sui-move-ts-bridge
• Generate TypeScript types from Move ABI
• Set up event listeners and dev environment
• If project needs historical data aggregation or custom analytics, call sui-indexer to set up a data pipeline (PostgreSQL + checkpoint processor)

Phase 5: Testing

• Call sui-tester for comprehensive testing
• Move unit/integration tests, frontend tests, E2E tests
• Gas benchmarks
• Auto-fix failing tests (max 5 retries)

Phase 6: Deployment

• Call sui-deployer with network selection
• Devnet (automated), Testnet (confirmation), Mainnet (strict checks)
• Record Package ID, update frontend .env
• Git tag for mainnet releases

Phase 7: Documentation (Optional)

• Generate technical docs, architecture docs, developer guide
• Query latest APIs via sui-docs-query

Git Checkpoints

Each phase includes a Git checkpoint:

1. Run sui-security-guard scan
2. Create commit with conventional message
3. Optionally push to GitHub

References

• Phase Details - Complete workflow for each phase
• Configuration - .sui-full-stack.json options and CLI usage
• Examples - Complete project walkthroughs

Integrated Skills

This skill orchestrates:

Skill	Phase	Purpose
sui-security-guard	All	Security at every checkpoint
sui-docs-query	All	Latest documentation
sui-architect	1	Architecture planning
sui-developer	2	Move development
sui-frontend	3	Frontend setup
sui-move-ts-bridge	4	Type generation
sui-tester	5	Comprehensive testing
sui-deployer	6	Multi-network deployment
sui-tools-guide	All	Tool selection
sui-indexer	4	Custom data pipelines (optional)

Common Mistakes

❌ Skipping phases

• Problem: Missing architecture docs, untested contracts, poor integration
• Fix: Follow phases sequentially, each builds on the previous

❌ Not using Git checkpoints

• Problem: Cannot rollback to working state, lost progress
• Fix: Commit after each phase with descriptive messages

❌ Deploying without comprehensive testing

• Problem: Bugs discovered in production, user funds at risk
• Fix: Complete Phase 5 (all test types) before Phase 6 deployment

❌ Ignoring security-guard warnings

• Problem: Secrets committed to Git, API keys exposed
• Fix: Fix all security warnings before committing

❌ Manual frontend package ID updates

• Problem: Frontend calls wrong package after redeployment
• Fix: Automate .env updates in deployment scripts

❌ Skipping frontend phase for backend-only projects

• Problem: No way to interact with contracts for testing
• Fix: Build minimal frontend or admin panel for contract interaction

❌ Not documenting custom workflows

• Problem: Team members cannot reproduce setup
• Fix: Generate docs in Phase 7, include setup instructions

---

From idea to production-ready SUI dApp - guided every step of the way!