中文
← Errors

F_SYSTEM_MISSING_APP_NAME

Missing application name

Config, Log, or another feature that requires an application directory did not receive appName.

Updated

What this error means

Features such as Config and Log create a ~/.<appName> directory from the application identity. Without appName, they cannot determine a safe storage location. The error usually appears when the relevant Provider initializes rather than when its Module is imported. At that point, details.appName is undefined.

How to fix it

Declare a stable name at the application entry:

src/index.ts
import { createApp } from 'func'
import { AppModule } from './app.module'

const app = createApp(AppModule, {
  appName: 'ship',
})

When testing these features through createInvoker or createTestingApp, supply the same appName in those options as well. The name must also satisfy the safe path-segment rules; otherwise F_SYSTEM_INVALID_APP_NAME is raised instead.