Configuration

Jamrock uses a dev.config.mjs file for build and development configuration.

Basic Configuration

Create dev.config.mjs in your project root:

export default {
  src: 'pages',
  dest: 'dist',
  port: 3000,
  host: '0.0.0.0',
  quiet: false,
  prefix: '@',
  public: 'public',
};

Configuration Options

CSS Generators

Enable CSS generators for Less and UnoCSS:

export default {
  generators: {
    less: await import('less'),
  },
  unocss: true,
};

Less

When enabled, use in components:

<style lang="less">
  @primary: #79C551;

  .button {
    color: @primary;
    &:hover { color: darken(@primary, 10%); }
  }
</style>

UnoCSS

When unocss: true is set, UnoCSS utility classes are generated:

<div class="flex gap-4 p-2 text-center">
  Content with utilities
</div>

Markdown Options

Configure markdown rendering:

export default {
  markdown: {
    emojify: true,
    twemoji: true,
  },
};

Environment Variables

Access environment variables in your components:

<script>
  const nodeEnv = process.env.NODE_ENV;
  const apiKey = process.env.API_KEY;
</script>

Build-time Variables

Set variables during build:

GIT_REVISION=$(git rev-parse HEAD) jamrock build

Runtime-Specific Config

Different runtimes may have additional options:

export default {
  // Node.js specific
  server: {
    keepAliveTimeout: 65000,
  },

  // Deno specific
  deno: {
    permissions: ['net', 'read', 'write'],
  },
};

Development vs Production

Detect the environment in your code:

<script>
  import { redirect } from 'jamrock:conn';

  if (process.env.NODE_ENV === 'production') {
    // Production-only code
  }
</script>