Guidewire Local Dev Loop

Overview

Set up an efficient local development workflow with Guidewire Studio, including hot reload, Gosu debugging, and continuous testing.

Prerequisites

• JDK 17 installed and configured

• IntelliJ IDEA (Ultimate recommended) or Guidewire Studio

• Gradle 8.x

• Git for version control

• Access to Guidewire Cloud sandbox environment

Instructions

Step 1: Configure IDE Settings

Install IntelliJ plugins: Gosu Language Support, Guidewire Studio Plugin, EditorConfig. Set Gradle JVM to JDK 17, enable auto-import, and set test runner to Gradle.

Step 2: Database Setup

createdb -U postgres pc_dev ./gradlew dbUpgrade ./gradlew loadSampleData # Generate sample data

Step 3: Start Development Server

./gradlew runServer # Start with hot reload ./gradlew runServer --debug-jvm # Start with debugging on port 5005 ./gradlew :policycenter:runServer # Start specific application

Step 4: Configure Hot Reload

Enable hot swap in config/dev-config.xml , then attach IntelliJ debugger to port 5005. Gosu and PCF changes will auto-reload.

Step 5: Run Tests

./gradlew test # All tests ./gradlew test --tests "gw.custom.MyServiceTest" # Specific class ./gradlew test jacocoTestReport # With coverage ./gradlew test --continuous # Watch mode

For detailed Gradle config, Gosu examples, PCF development, and keyboard shortcuts, load the reference guide: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

• Running local development server

• Hot reload enabled for Gosu and PCF changes

• Debug session attached to IDE

• Unit tests executing successfully

Error Handling

Error Cause Solution

Port already in use Server already running Kill existing process or change port

Database connection failed Wrong credentials/missing DB Check postgres is running

Gosu compilation error Syntax error Check IDE error highlights

Hot reload not working Debug not attached Reconnect debugger

Out of memory Insufficient heap Increase -Xmx in jvmArgs

Resources

• Guidewire Studio Documentation

• Gosu Language Reference

• Gradle Plugin Documentation

Next Steps

For SDK and API patterns, see guidewire-sdk-patterns .

Examples

Basic usage: Apply guidewire local dev loop to a standard project setup with default configuration options.

Advanced scenario: Customize guidewire local dev loop for production environments with multiple constraints and team-specific requirements.