Build Options

Options specific to production builds (orgp build).

buildConcurrency

Type: number
Default: os.cpus().length (number of CPU cores)

Number of pages to render concurrently during build. Higher values speed up builds on multi-core machines but use more memory.

export default {
  // Limit to 4 concurrent pages
  buildConcurrency: 4,
};

For memory-constrained environments (CI, containers), you may want to reduce this:

export default {
  buildConcurrency: process.env.CI ? 2 : undefined,
};

uniorg

Type: Record<string, any>
Default: {}

Options passed to the uniorg parser. This controls how org-mode files are parsed.

export default {
  uniorg: {
    // Parser options passed to uniorg
  },
};

vite.build

Vite build-specific configuration merged with org-press defaults.

export default {
  vite: {
    build: {
      // Enable source maps for debugging
      sourcemap: true,

      // Minification (default: esbuild)
      minify: "esbuild",

      // Output target
      target: "esnext",

      // Chunk size warnings
      chunkSizeWarningLimit: 500,
    },
  },
};

Common Build Options

sourcemap

Generate source maps for debugging production builds:

vite: {
  build: {
    sourcemap: true,      // Generate .map files
    sourcemap: "hidden",  // Generate but don't link
    sourcemap: "inline",  // Inline in JS files
  }
}

target

Browser compatibility target:

vite: {
  build: {
    target: "es2020",  // Wider browser support
    target: "esnext",  // Latest features (default)
  }
}

assetsInlineLimit

Inline assets smaller than this limit (bytes):

vite: {
  build: {
    assetsInlineLimit: 4096,  // 4kb (default)
  }
}