@konomi-app/k2-vite

🍳 Minimal kintone development environment with Vite

Features

• ⚡ Vite-powered - Fast development and build
• 🔒 SSL-ready - Automatic HTTPS for local development
• 📦 Simple output - src/{appName}/index.ts → {appName}.js + {appName}.css
• 🛠️ CLI & API - Use from command line or JavaScript

Installation

npm install @konomi-app/k2-vite vite chokidar
# or
pnpm add @konomi-app/k2-vite vite chokidar

Prerequisites

For SSL certificate generation, install mkcert:

# Windows (with Chocolatey)
choco install mkcert

# macOS (with Homebrew)
brew install mkcert

# Then install the local CA
mkcert -install

Project Structure

your-project/
├── src/
│   ├── app-1/
│   │   └── index.ts    # Entry point for app-1
│   ├── app-2/
│   │   └── index.tsx   # Entry point for app-2
│   └── shared/
│       └── utils.ts    # Shared utilities
└── package.json

Output:

.k2/prod/
├── app-1.js
├── app-1.css
├── app-2.js
└── app-2.css

CLI Usage

Build for Production

npx k2-vite build

# With options
npx k2-vite build --input src --outdir dist

Development Server

npx k2-vite dev

# With options
npx k2-vite dev --port 3000 --input src

Options:

• -i, --input <dir> - Input directory (default: src)
• -o, --outdir <dir> - Output directory (default: .k2/prod for build, .k2/dev for dev)
• -c, --certdir <dir> - SSL certificate directory (default: .k2)
• -p, --port <number> - Dev server port (default: 32767)

JavaScript API

import { build, dev, createViteConfig } from '@konomi-app/k2-vite';

// Build for production
await build({
  input: 'src',
  outDir: 'dist',
});

// Start development server
await dev({
  input: 'src',
  port: 3000,
});

// Custom Vite configuration
await build({
  input: 'src',
  viteConfig: {
    plugins: [
      /* your plugins */
    ],
    define: {
      'process.env.NODE_ENV': '"production"',
    },
  },
});

Configuration

With vite-tsconfig-paths (Optional)

If you want to use TypeScript path aliases:

npm install vite-tsconfig-paths

The plugin will be automatically detected and used.

Custom Vite Config

You can pass additional Vite configuration:

import { build } from '@konomi-app/k2-vite';
import react from '@vitejs/plugin-react';

await build({
  viteConfig: {
    plugins: [react()],
  },
});

License

ISC