Spock Docs Theme

Dark and Light VS Code themes inspired by the syntax highlighting and color palette used in the Spock Framework documentation.

Designed especially for Groovy, Java, and Spock tests, with clear BDD block highlighting and readable contrast.

✨ Features

🎨 Dark Theme

• Background: #2d3748 (matches Spock docs code blocks)

• Soft cool foreground: #e2e8f0

• Spock block keywords (given:, when:, then:, where:) highlighted

• Purple annotations (@Unroll, @Shared, @Ignore, etc.)

• Clear distinction for:

  • Strings
  • Numbers
  • Class names
  • Comments
  • Keywords

• Identifiers (methods, variables) remain readable and neutral

🌞 Light Theme

• Soft gray background (not pure white)
• Carefully tuned contrast
• Matching purple annotation styling
• Optimized for long coding sessions

🧪 Optimized For

• Groovy
• Java
• Spock Framework tests
• BDD-style specifications

Example:

class CalculatorSpec extends Specification {

    @Unroll
    def "max of #a and #b is #c"() {

        given:
        def calculator = new Calculator()

        when:
        def result = calculator.max(a, b)

        then:
        result == c

        where:
        a | b | c
        1 | 3 | 3
    }
}

• given/when/then/where → keyword color
• @Unroll → purple annotation
• Methods & variables → neutral readable foreground
• Strings & numbers → clearly distinguishable

📦 Installation

From VSIX

1. Open VS Code
2. Go to Extensions panel
3. Click ⋯
4. Select Install from VSIX
5. Choose the packaged .vsix file
6. Reload VS Code

From Marketplace

1. Open Extensions
2. Search for Spock Docs Theme
3. Click Install
4. Select theme from Preferences → Color Theme

🎯 Included Themes

• Spock Docs Dark
• Spock Docs Light

Switch between them using:

Preferences → Color Theme

🎨 Color Philosophy

The palette mirrors the tone of the Spock documentation:

• Calm dark slate background
• Soft pastel syntax accents
• Minimal noise for identifiers
• Clear structural highlighting for test readability

The goal is to make Spock tests visually structured and pleasant to read.

🚀 Publishing

This extension can be packaged using:

vsce package

And published using:

vsce publish

Make sure your publisher field in package.json matches your Marketplace publisher ID.

📜 License

MIT (or choose your preferred license)

If you'd like, I can also generate:

• A polished marketplace description version (SEO optimized)
• A minimal GitHub repository structure
• A badge section (downloads, version, license)
• A matching logo concept description for branding

Just tell me 🙂