Home Guides Interfaces Troubleshooting

# Bundle Structure Issues

- Hidden files
- <item> cannot be in the root of the bundle
- Bundle requires a <item>
- "<item>" must be named "<name>"

## Hidden files

Some hidden files or folders will generate the "detritus" error. Apple's documentation doesn't mention hidden files developer.apple.com/qa1940, removing hidden files can solve this issue.

## <item> cannot be in the root of the bundle

Placing files in the root of an application bundle goes against Apple's Bundle Programming guidelines, some versions of code sign will refuse to sign an application bundle if files are present here.

## Bundle requires a <item>

Mac Application bundles have required items, see Apple's Bundle Programming guidelines and App Wrapper cannot find one.

## "<item>" must be named "<name>"

Generally this is because the name case doesn't match the requirements, this issue can be hard to track down on a case-insensitive system, but causes many failures on case-sensitive systems.