Skip to content

vixt / core / VixtConfig

VixtConfig

Extended by

Properties

alias?

optional alias?: AliasOptions

You can improve your DX by defining additional aliases to access custom directories within your JavaScript and CSS.

Default

json
{
  "@": "/<rootDir>/<srcDir>",
  "~": "/<rootDir>/<srcDir>",
  "~~": "/<rootDir>",
  "@@": "/<rootDir>",
  "#": "/<rootDir>/<buildDir>"
}

app?

optional app?: AppOptions

Vixt App configuration.


appConfig?

optional appConfig?: Record<string, any>

Additional app configuration.


build?

optional build?: BuildOptions

Shared build configuration.


buildDir?

optional buildDir?: string

Define the directory where your built files will be placed.

Default

ts
'<rootDir>/.vixt'

buildLayersDir?

optional buildLayersDir?: string

Default

ts
'<buildDir>/layers'

buildTypesDir?

optional buildTypesDir?: string

Default

ts
'<buildDir>/types'

copyLayers?

optional copyLayers?: boolean

Experimental

Whether to copy layers from node_modules to .vixt/layers

Default

ts
true
@experimental

debug?

optional debug?: boolean

Set to true to enable debug mode.

Default

ts
false

dev?

optional dev?: boolean

Whether your app is running in development mode.

Default

ts
false

devServer?

optional devServer?: DevServerOptions

Set CORS options for the dev server, the port, host, cors options will be passed to vite.server


extends?

optional extends?: string[]

Extend project from multiple local or remote sources.


imports?

optional imports?: ImportsOptions

Configure how Vixt auto-imports composables into your application.


meta?

optional meta?: VixtConfigLayerMeta

Custom meta for layer.


modules?

optional modules?: VixtModule<ModuleOptions>[]

Modules are Vixt extensions which can extend its core functionality and add endless integrations.


modulesDir?

optional modulesDir?: string

Define the directory of your Vixt modules.

Default

ts
'<srcDir>/modules'

nitro?

optional nitro?: NitroOptions

Configuration for Nitro.


plugins?

optional plugins?: string[]

An array of vixt app plugins.


pluginsDir?

optional pluginsDir?: string

Define the directory of your Vixt plugins.

Default

ts
'<srcDir>/plugins'

rootDir?

optional rootDir?: string

Define the root directory of your application.

Default

ts
process.cwd()

srcDir?

optional srcDir?: string

Define the source directory of your application.

Default

ts
'<rootDir>/src'

ssr?

optional ssr?: boolean

Whether to enable rendering of HTML.


test?

optional test?: boolean

Whether your app is being unit tested.

Default

ts
false

typescript?

optional typescript?: TypescriptOptions

Configuration for TypeScript integration.


vite?

optional vite?: Omit<UserConfig, "plugins">

Configuration that will be passed directly to Vite.


workspaceDir?

optional workspaceDir?: string

Define the monorepo workspace directory of your application.