SpeedZcode

SpeedZcode is a VS Code extension that speeds up common project tasks and scaffolding for Flutter and Go projects. It reduces boilerplate, automates flavor and icon setup, and helps you scaffold modules, endpoints and full projects quickly.

What problem this solves

• Saves time by generating project and module boilerplate.
• Standardizes common setup tasks (flavors, icons, entry points).
• Helps teams keep consistent project structure across environments.

Key features

• Project creation templates (Flutter / Go)
• Module and endpoint scaffolding
• Flavor and splash/icon setup for Flutter apps
• Project helper commands accessible from the side panel and Command Palette

Requirements

• VS Code 1.104.0 or higher
• Flutter and Dart installed (when using Flutter)
• Go , SQLC , Docker , installed ( when using Go )

Installation

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X)
3. Search for "SpeedZcode" and install
4. Reload VS Code if prompted

⚡ Quick Start — Basic Workflow (Side Panel)

SpeedzCode works primarily through the Activity Bar companion (side panel).

Steps

1. Open SpeedzCode Companion from the VS Code Activity Bar.
2. Choose between:
   • Chat Panel (guided, step-by-step)
   • Action List (direct commands)
3. Sign in if prompted

   Some advanced features require account authentication.

📌 No CLI. No config. Everything runs inside VS Code.

🎥 **GIF

🧠 Context-Aware Behavior (How SpeedzCode Decides)

SpeedzCode automatically detects your project type based on the current directory.

Detection Rules

1. If pubspec.yaml exists
   → Flutter actions are shown
2. If go.mod exists
   → Go actions are shown
3. If neither exists
   → The side panel shows:
   • Create Flutter Project
   • Create Go Project

This keeps the UI clean and relevant.

🎥 **GIF

🐦 Flutter — Usage Examples

Create Flutter Project

Command: Create Flutter Project

Flow

1. Select project location
2. Enter project name
3. SpeedzCode:
   • Sets up project structure
   • Applies recommended configuration
   • Click Open Project

👉 After creation, read the generated README.md for next steps.

🎥 **GIF

Create Flutter Module (Feature)

Command: Create Flutter Module

Flow

1. Enter module / feature name
2. Upload UI image for UI generation (optional)
3. SpeedzCode generates:
   • Feature folder
   • Routing
   • Initial UI + logic wiring

📦 Result: feature is ready to use, not just folders.

🎥 **GIF

Create Flutter API Endpoint

Command: Create Flutter Endpoint

Flow

1. Enter endpoint name
2. Choose whether authentication is required
3. Provide request JSON (must be valid)
4. Provide response JSON (must be valid)
5. Select the target module

Generated Automatically

• Data layer (API + models)

• Domain layer

• Cubits / state management

• Dependency injection wiring

  🎥 **GIF

🐹 Go — Usage Examples

Create Go Project

Command: Create Go Project

Flow

1. Select project location
2. Enter project name
3. Enter repository URL
4. SpeedzCode:
   • Generates clean architecture structure
   • Configures base setup
   • Click Open Project

Optional Post-Setup

1. Review README.md

2. Review Makefile

3. Configure Docker + Postgres

4. Run setup command:

   make setup

   🎥 **GIF

Create Go API Endpoint

Command: Create Go Endpoint

Flow

1. Enter endpoint name
2. Choose whether authentication is required
3. Provide request JSON (must be valid)
4. Provide response JSON (must be valid)
5. Select the target table

Generated Automatically

• App layer
• Delivery (HTTP handlers)
• Domain logic
• DTOs & mappers
• Dependency injection wiring

📦 Result: endpoint is wired, testable, and ready to extend.

🎥 **GIF

🎯 When to Use SpeedzCode

• Starting a new Go or Flutter project
• Adding new features consistently
• Enforcing team-wide structure
• Avoiding repetitive setup work

⚙️ Configuration

• SpeedzCode currently works with zero configuration.
• All structures are opinionated and production-focused.

Troubleshooting

• If a Flutter operation fails, ensure flutter is on your PATH and runs from terminal.
• If a Go operation fails, ensure go is on your PATH and runs from terminal.
• Reload the window (Cmd+Shift+P → "Developer: Reload Window") after installing the extension.

🌐 Links

Website: https://speedzcode.org

GitHub: https://github.com/speedzcode

SpeedzCode = Commands that generate structure, not magic.

Release Notes

1.0.0

• Initial release: project scaffolding, module creation, endpoint generation, flavor and icon helpers