micsapp 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
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.