@raystack/chronicle 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/chronicle",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Config-driven documentation framework",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,15 +9,14 @@
     "dist",
     "src",
     "templates",
-    "next.config.mjs",
-    "source.config.ts",
     "tsconfig.json"
   ],
   "bin": {
     "chronicle": "./bin/chronicle.js"
   },
   "scripts": {
-    "build:cli": "bun build-cli.ts"
+    "build:cli": "bun build-cli.ts",
+    "lint": "biome lint src/"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
@@ -37,26 +36,36 @@
     "@codemirror/theme-one-dark": "^6.1.3",
     "@codemirror/view": "^6.39.14",
     "@heroicons/react": "^2.2.0",
-    "@raystack/apsara": "^0.56.0",
-    "@types/unist": "^3.0.3",
+    "@raystack/apsara": "0.55.1",
+    "@shikijs/rehype": "^4.0.2",
+    "@vitejs/plugin-react": "^6.0.1",
     "chalk": "^5.6.2",
     "class-variance-authority": "^0.7.1",
     "codemirror": "^6.0.2",
     "commander": "^14.0.2",
     "fumadocs-core": "16.6.15",
     "fumadocs-mdx": "^14.2.6",
+    "glob": "^11.0.0",
+    "gray-matter": "^4.0.3",
+    "h3": "^2.0.1-rc.16",
     "lodash": "^4.17.23",
     "mermaid": "^11.13.0",
-    "next": "16.1.6",
+    "minisearch": "^7.2.0",
+    "nitro": "3.0.260311-beta",
+    "openapi-types": "^12.1.3",
     "react": "^19.0.0",
-    "react-device-detect": "^2.2.3",
     "react-dom": "^19.0.0",
-    "remark-attr": "^0.11.1",
+    "react-router": "^7.13.1",
     "remark-directive": "^4.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx-frontmatter": "^5.2.0",
+    "remark-parse": "^11.0.0",
+    "satori": "^0.25.0",
     "slugify": "^1.6.6",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
-    "openapi-types": "^12.1.3",
+    "vite": "^8.0.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   }

package/src/cli/commands/build.ts

@@ -1,38 +1,40 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { loadCLIConfig } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
 
 export const buildCommand = new Command('build')
   .description('Build for production')
-  .action(() => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .option('--content <path>', 'Content directory')
+  .option('--config <path>', 'Path to chronicle.yaml')
+  .option(
+    '--preset <preset>',
+    'Deploy preset (vercel, cloudflare, node-server)'
+  )
+  .action(async options => {
+    const { contentDir, configPath, preset } = await loadCLIConfig(options.config, {
+      content: options.content,
+      preset: options.preset,
+    });
+    await linkContent(contentDir);
 
-    let nextCli: string
-    try {
-      nextCli = resolveNextCli()
-    } catch {
-      console.log(chalk.red('Error: Next.js CLI not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+    console.log(chalk.cyan('Building for production...'));
 
-    console.log(chalk.cyan('Building for production...'))
+    const { createBuilder } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    const child = spawn(process.execPath, [nextCli, 'build'], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const config = await createViteConfig({
+      packageRoot: PACKAGE_ROOT,
+      projectRoot: process.cwd(),
+      contentDir,
+      configPath,
+      preset
+    });
 
-    attachLifecycleHandlers(child)
-  })
+    const builder = await createBuilder({ ...config, builder: {} });
+    await builder.buildApp();
+
+    console.log(chalk.green('Build complete'));
+    console.log(chalk.cyan('Run `chronicle start` to start the server'));
+  });

package/src/cli/commands/dev.ts

@@ -1,39 +1,31 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { loadCLIConfig } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
 
 export const devCommand = new Command('dev')
   .description('Start development server')
   .option('-p, --port <port>', 'Port number', '3000')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .option('--content <path>', 'Content directory')
+  .option('--config <path>', 'Path to chronicle.yaml')
+  .action(async options => {
+    const { contentDir, configPath } = await loadCLIConfig(options.config, { content: options.content });
+    const port = parseInt(options.port, 10);
 
-    let nextCli: string
-    try {
-      nextCli = resolveNextCli()
-    } catch {
-      console.log(chalk.red('Error: Next.js CLI not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+    await linkContent(contentDir);
 
-    console.log(chalk.cyan('Starting dev server...'))
+    console.log(chalk.cyan('Starting dev server...'));
 
-    const child = spawn(process.execPath, [nextCli, 'dev', '-p', options.port], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const { createServer } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    attachLifecycleHandlers(child)
-  })
+    const config = await createViteConfig({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir, configPath });
+    const server = await createServer({
+      ...config,
+      server: { ...config.server, port }
+    });
+
+    await server.listen();
+    server.printUrls();
+  });

package/src/cli/commands/init.ts

@@ -1,44 +1,16 @@
-import { Command } from 'commander'
-import { execSync } from 'child_process'
-import fs from 'fs'
-import path from 'path'
-import chalk from 'chalk'
-import { stringify } from 'yaml'
-import type { ChronicleConfig } from '@/types'
-import { loadCLIConfig, scaffoldDir, detectPackageManager, getChronicleVersion } from '@/cli/utils'
-
-
-function createConfig(): ChronicleConfig {
-  return {
-    title: 'My Documentation',
-    description: 'Documentation powered by Chronicle',
-    theme: { name: 'default' },
-    search: { enabled: true, placeholder: 'Search documentation...' },
-  }
-}
-
-function createPackageJson(name: string): Record<string, unknown> {
-  return {
-    name,
-    private: true,
-    type: 'module',
-    scripts: {
-      dev: 'chronicle dev',
-      build: 'chronicle build',
-      start: 'chronicle start',
-    },
-    dependencies: {
-      '@raystack/chronicle': `^${getChronicleVersion()}`,
-    },
-    devDependencies: {
-      '@raystack/tools-config': '0.56.0',
-      'openapi-types': '^12.1.3',
-      typescript: '5.9.3',
-      '@types/react': '^19.2.10',
-      '@types/node': '^25.1.0',
-    },
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { stringify } from 'yaml';
+import type { ChronicleConfig } from '@/types';
+
+const defaultConfig: ChronicleConfig = {
+  title: 'My Documentation',
+  description: 'Documentation powered by Chronicle',
+  theme: { name: 'default' },
+  search: { enabled: true, placeholder: 'Search documentation...' }
+};
 
 const sampleMdx = `---
 title: Welcome
@@ -49,115 +21,49 @@ order: 1
 # Welcome
 
 This is your documentation home page.
-`
+`;
 
 export const initCommand = new Command('init')
   .description('Initialize a new Chronicle project')
   .option('-c, --content <path>', 'Content directory name', 'content')
-  .action((options) => {
-    const projectDir = process.cwd()
-    const dirName = path.basename(projectDir) || 'docs'
-    const contentDir = path.join(projectDir, options.content)
+  .action(options => {
+    const projectDir = process.cwd();
+    const contentDir = path.join(projectDir, options.content);
 
-    // Create content directory if it doesn't exist
     if (!fs.existsSync(contentDir)) {
-      fs.mkdirSync(contentDir, { recursive: true })
-      console.log(chalk.green('✓'), 'Created', contentDir)
-    }
-
-    // Create or update package.json in project root
-    const packageJsonPath = path.join(projectDir, 'package.json')
-    if (!fs.existsSync(packageJsonPath)) {
-      fs.writeFileSync(packageJsonPath, JSON.stringify(createPackageJson(dirName), null, 2) + '\n')
-      console.log(chalk.green('✓'), 'Created', packageJsonPath)
-    } else {
-      const existing = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))
-      const template = createPackageJson(dirName)
-      let updated = false
-
-      // Set type to module
-      if (existing.type !== 'module') {
-        existing.type = 'module'
-        updated = true
-      }
-
-      // Merge missing scripts
-      if (!existing.scripts) existing.scripts = {}
-      for (const [key, value] of Object.entries(template.scripts as Record<string, string>)) {
-        if (!existing.scripts[key]) {
-          existing.scripts[key] = value
-          updated = true
-        }
-      }
-
-      // Merge missing dependencies
-      if (!existing.dependencies) existing.dependencies = {}
-      for (const [key, value] of Object.entries(template.dependencies as Record<string, string>)) {
-        if (!existing.dependencies[key]) {
-          existing.dependencies[key] = value
-          updated = true
-        }
-      }
-
-      // Merge missing devDependencies
-      if (!existing.devDependencies) existing.devDependencies = {}
-      for (const [key, value] of Object.entries(template.devDependencies as Record<string, string>)) {
-        if (!existing.devDependencies[key]) {
-          existing.devDependencies[key] = value
-          updated = true
-        }
-      }
-
-      if (updated) {
-        fs.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + '\n')
-        console.log(chalk.green('✓'), 'Updated', packageJsonPath, 'with missing scripts/deps')
-      } else {
-        console.log(chalk.yellow('⚠'), packageJsonPath, 'already has all required entries')
-      }
+      fs.mkdirSync(contentDir, { recursive: true });
+      console.log(chalk.green('\u2713'), 'Created', contentDir);
     }
 
-    // Create chronicle.yaml in project root
-    const configPath = path.join(projectDir, 'chronicle.yaml')
+    const configPath = path.join(projectDir, 'chronicle.yaml');
     if (!fs.existsSync(configPath)) {
-      fs.writeFileSync(configPath, stringify(createConfig()))
-      console.log(chalk.green('✓'), 'Created', configPath)
+      fs.writeFileSync(configPath, stringify(defaultConfig));
+      console.log(chalk.green('\u2713'), 'Created', configPath);
     } else {
-      console.log(chalk.yellow('⚠'), configPath, 'already exists')
+      console.log(chalk.yellow('\u26a0'), configPath, 'already exists');
     }
 
-    // Create sample index.mdx only if content dir is empty
-    const contentFiles = fs.readdirSync(contentDir)
+    const contentFiles = fs.readdirSync(contentDir);
     if (contentFiles.length === 0) {
-      const indexPath = path.join(contentDir, 'index.mdx')
-      fs.writeFileSync(indexPath, sampleMdx)
-      console.log(chalk.green('✓'), 'Created', indexPath)
+      const indexPath = path.join(contentDir, 'index.mdx');
+      fs.writeFileSync(indexPath, sampleMdx);
+      console.log(chalk.green('\u2713'), 'Created', indexPath);
     }
 
-    // Add entries to .gitignore
-    const gitignorePath = path.join(projectDir, '.gitignore')
-    const gitignoreEntries = ['.chronicle', 'node_modules', '.next']
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    const gitignoreEntries = ['node_modules', 'dist', '.output'];
     if (fs.existsSync(gitignorePath)) {
-      const existing = fs.readFileSync(gitignorePath, 'utf-8')
-      const missing = gitignoreEntries.filter(e => !existing.includes(e))
+      const existing = fs.readFileSync(gitignorePath, 'utf-8');
+      const missing = gitignoreEntries.filter(e => !existing.includes(e));
       if (missing.length > 0) {
-        fs.appendFileSync(gitignorePath, `\n${missing.join('\n')}\n`)
-        console.log(chalk.green('✓'), 'Added', missing.join(', '), 'to .gitignore')
+        fs.appendFileSync(gitignorePath, `\n${missing.join('\n')}\n`);
+        console.log(chalk.green('\u2713'), 'Added', missing.join(', '), 'to .gitignore');
       }
     } else {
-      fs.writeFileSync(gitignorePath, `${gitignoreEntries.join('\n')}\n`)
-      console.log(chalk.green('✓'), 'Created .gitignore')
+      fs.writeFileSync(gitignorePath, `${gitignoreEntries.join('\n')}\n`);
+      console.log(chalk.green('\u2713'), 'Created .gitignore');
     }
 
-    // Install dependencies
-    const pm = detectPackageManager()
-    console.log(chalk.cyan(`\nInstalling dependencies with ${pm}...`))
-    execSync(`${pm} install`, { cwd: projectDir, stdio: 'inherit' })
-
-    // Scaffold .chronicle/ directory
-    loadCLIConfig(contentDir)
-    scaffoldDir(contentDir)
-
-    const runCmd = pm === 'npm' ? 'npx' : pm === 'bun' ? 'bunx' : `${pm} dlx`
-    console.log(chalk.green('\n✓ Chronicle initialized!'))
-    console.log('\nRun', chalk.cyan(`${runCmd} chronicle dev`), 'to start development server')
-  })
+    console.log(chalk.green('\n\u2713 Chronicle initialized!'));
+    console.log('\nRun', chalk.cyan('chronicle dev'), 'to start development server');
+  });

package/src/cli/commands/serve.ts

@@ -1,59 +1,45 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { loadCLIConfig } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
 
 export const serveCommand = new Command('serve')
   .description('Build and start production server')
   .option('-p, --port <port>', 'Port number', '3000')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
-
-    let nextCli: string
-    try {
-      nextCli = resolveNextCli()
-    } catch {
-      console.log(chalk.red('Error: Next.js CLI not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
-
-    const env = {
-      ...process.env,
-      CHRONICLE_PROJECT_ROOT: process.cwd(),
-      CHRONICLE_CONTENT_DIR: './content',
-    }
-
-    console.log(chalk.cyan('Building for production...'))
-
-    const buildChild = spawn(process.execPath, [nextCli, 'build'], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env,
-    })
-
-    process.once('SIGINT', () => buildChild.kill('SIGINT'))
-    process.once('SIGTERM', () => buildChild.kill('SIGTERM'))
-
-    buildChild.on('close', (code) => {
-      if (code !== 0) {
-        console.log(chalk.red('Build failed'))
-        process.exit(code ?? 1)
-      }
-
-      console.log(chalk.cyan('Starting production server...'))
-
-      const startChild = spawn(process.execPath, [nextCli, 'start', '-p', options.port], {
-        stdio: 'inherit',
-        cwd: scaffoldPath,
-        env,
-      })
-
-      attachLifecycleHandlers(startChild)
-    })
-  })
+  .option('--content <path>', 'Content directory')
+  .option('--config <path>', 'Path to chronicle.yaml')
+  .option(
+    '--preset <preset>',
+    'Deploy preset (vercel, cloudflare, node-server)'
+  )
+  .action(async options => {
+    const { contentDir, configPath, preset } = await loadCLIConfig(options.config, {
+      content: options.content,
+      preset: options.preset,
+    });
+    const port = parseInt(options.port, 10);
+    await linkContent(contentDir);
+
+    const { build, preview } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
+
+    const config = await createViteConfig({
+      packageRoot: PACKAGE_ROOT,
+      projectRoot: process.cwd(),
+      contentDir,
+      configPath,
+      preset
+    });
+
+    console.log(chalk.cyan('Building for production...'));
+    await build(config);
+
+    console.log(chalk.cyan('Starting production server...'));
+    const server = await preview({
+      ...config,
+      preview: { port }
+    });
+
+    server.printUrls();
+  });

package/src/cli/commands/start.ts

@@ -1,39 +1,28 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { loadCLIConfig } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
 
 export const startCommand = new Command('start')
   .description('Start production server')
   .option('-p, --port <port>', 'Port number', '3000')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .option('--content <path>', 'Content directory')
+  .action(async options => {
+    const { contentDir, configPath } = await loadCLIConfig(undefined, { content: options.content });
+    const port = parseInt(options.port, 10);
+    await linkContent(contentDir);
 
-    let nextCli: string
-    try {
-      nextCli = resolveNextCli()
-    } catch {
-      console.log(chalk.red('Error: Next.js CLI not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+    console.log(chalk.cyan('Starting production server...'));
 
-    console.log(chalk.cyan('Starting production server...'))
+    const { preview } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    const child = spawn(process.execPath, [nextCli, 'start', '-p', options.port], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const config = await createViteConfig({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir, configPath });
+    const server = await preview({
+      ...config,
+      preview: { port }
+    });
 
-    attachLifecycleHandlers(child)
-  })
+    server.printUrls();
+  });

package/src/cli/index.ts

@@ -1,21 +1,21 @@
-import { Command } from 'commander'
-import { initCommand } from './commands/init'
-import { devCommand } from './commands/dev'
-import { buildCommand } from './commands/build'
-import { startCommand } from './commands/start'
-import { serveCommand } from './commands/serve'
+import { Command } from 'commander';
+import { buildCommand } from './commands/build';
+import { devCommand } from './commands/dev';
+import { initCommand } from './commands/init';
+import { serveCommand } from './commands/serve';
+import { startCommand } from './commands/start';
 
-const program = new Command()
+const program = new Command();
 
 program
   .name('chronicle')
   .description('Config-driven documentation framework')
-  .version('0.1.0')
+  .version('0.1.0');
 
-program.addCommand(initCommand)
-program.addCommand(devCommand)
-program.addCommand(buildCommand)
-program.addCommand(startCommand)
-program.addCommand(serveCommand)
+program.addCommand(initCommand);
+program.addCommand(devCommand);
+program.addCommand(buildCommand);
+program.addCommand(startCommand);
+program.addCommand(serveCommand);
 
-program.parse()
+program.parse();