Configuration Reference

TL;DR

Complete reference for manic.config.ts - covers all configuration options with full TypeScript type definitions.

The manic.config.ts file (or .js) is the source of truth for your application's build and runtime behavior. Use the defineConfig helper to ensure full type safety.

Config helpers

createPlugin

Author plugins staticFiles hooks

import { defineConfig } from 'manicjs/config';

export default defineConfig({
  mode: 'fullstack',
  app: {
    name: 'My Manic App',
  },
  server: {
    port: 6070,
  },
});

OXC Configuration

Customize the OXC transformer for advanced optimization:

import { defineConfig } from 'manicjs/config';

export default defineConfig({
  oxc: {
    target: 'es2022',
    minify: true,
    mangle: true,
  },
});

Plugins & Providers

Using Plugins

import { defineConfig } from 'manicjs/config';
import { tailwind } from '@manicjs/tailwind';
import { mdx } from '@manicjs/mdx';

export default defineConfig({
  plugins: [
    tailwind(),
    mdx({
      frontmatter: true,
      gfm: true,
    }),
  ],
});

Using Providers

import { defineConfig } from 'manicjs/config';
import { vercel } from '@manicjs/providers';
import { cloudflare } from '@manicjs/providers';

export default defineConfig({
  providers: [
    vercel({
      regions: ['sfo1', 'iad1'],
    }),
    cloudflare(),
  ],
});

manic.config.ts does not declare runtime env vars. Use .env / .env.local files and read values with getEnv from manicjs/env (client: MANIC_PUBLIC_* only) or process.env on the server.

See Environment variables.

Full Example

import { defineConfig } from 'manicjs/config';
import { vercel } from '@manicjs/providers';
import { tailwind } from '@manicjs/tailwind';

export default defineConfig({
  mode: 'fullstack',

  app: {
    name: 'My Manic App',
  },

  server: {
    port: 6070,
    hmr: true,
  },

  router: {
    viewTransitions: true,
    preserveScroll: false,
    scrollBehavior: 'smooth',
  },

  build: {
    outdir: '.manic',
    minify: true,
    splitting: true,
    sourcemap: 'inline',
  },

  sitemap: {
    hostname: 'https://example.com',
    exclude: ['/admin/**'],
    changefreq: 'weekly',
    priority: 0.7,
  },

  oxc: {
    target: 'es2022',
  },

  plugins: [tailwind()],

  providers: [vercel()],
});

Configuration

Configuration Reference

Config helpers

defineConfig

loadConfig

getConfig

createPlugin

Top-Level Options

`app` Settings

`server` Settings

`router` Settings

`build` Settings

Sitemap Configuration

Sitemap Options

OXC Configuration

Plugins & Providers

Using Plugins

Using Providers

Environment variables

Full Example

On this page