# Settings file 'settings.gradle' not found. Please create one or run Gradle from the root project directory.

- **ID:** `java/gradle-missing-settings-file`
- **Domain:** java
- **Category:** build_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

Gradle expects a settings.gradle file in the project root directory to define project structure.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 7+ | active | — | — |

## Workarounds

1. **Create a settings.gradle file with the project name** (95% success)
   ```
   rootProject.name = 'my-app'
   ```
2. **Include subprojects if applicable** (90% success)
   ```
   rootProject.name = 'my-app'
include 'subproject-a', 'subproject-b'
   ```

## Dead Ends

- **Running Gradle from a subdirectory without a settings file** — Gradle cannot determine the project structure without a settings file. (90% fail)
- **Creating an empty settings.gradle file** — An empty file may be accepted, but it will not include any subprojects, which may be needed. (50% fail)