Getting Started

Introduction

DevKernel is a next-generation development infrastructure platform that provides the foundational layer for building, deploying, and scaling modern applications. Think of it as the kernel of your development stack.

Key Features

  • Sub-second build times
  • Global edge deployment
  • Real-time code analysis
  • AI-powered code review
  • Zero-config pipelines
  • First-class TypeScript support

Installation

Install the DevKernel CLI globally using your preferred package manager:

npm
$ npm install -g @devkernel/cli
pnpm
$ pnpm add -g @devkernel/cli
yarn
$ yarn global add @devkernel/cli

Requires Node.js 18.0 or later.

Quick Start

Get your first project up and running in under a minute:

1 Initialize your project

$ npx devkernel init my-app
✓ Project initialized successfully

2 Start the development server

$ cd my-app && npx devkernel dev
ⓘ Server running at http://localhost:3000

3 Deploy to production

$ npx devkernel deploy --prod
✓ Deployed to https://my-app.devkernel.studio
Core Concepts

Projects

A Project in DevKernel represents a single application or service. Each project has its own configuration, environment variables, deployment history, and custom domain settings.

Projects are defined by a devkernel.config.ts file at the root of your repository:

devkernel.config.ts
import { defineConfig } from '@devkernel/cli';
export default defineConfig({
  name: 'my-app',
  runtime: 'edge',
  regions: ['us-east', 'eu-west', 'ap-south'],
  build: {
    command: 'npm run build',
    output: 'dist'
  }
});

Deployments

Every git push automatically triggers a deployment. DevKernel builds your project, optimizes assets, and distributes them across the global edge network.

Deployment Lifecycle

Push Build Optimize Deploy Live

Edge Runtime

DevKernel's Edge Runtime executes your server-side code at the network edge, as close to your users as possible. With 300+ points of presence worldwide, responses are typically delivered in under 50ms.

312
Edge Nodes
<50ms
P99 Latency
6
Continents
API Reference

SDK Reference

The DevKernel SDK provides a type-safe interface for managing projects, deployments, and infrastructure programmatically.

sdk-example.ts
import { DevKernel, type DeployOptions } from '@devkernel/sdk';
const client = new DevKernel({
  apiKey: process.env.DEVKERNEL_API_KEY
});
// List all projects
const projects = await client.projects.list();
// Trigger a deployment
const deployment = await client.deploy({
  project: 'my-app',
  target: 'production'
});
console.log(deployment.url);
// => https://my-app.devkernel.studio

REST API

All DevKernel functionality is accessible via our REST API. Base URL: https://api.devkernel.studio/v1

GET /projects List all projects
POST /projects/{id}/deploy Trigger deployment
GET /deployments/{id}/logs Stream build logs
PUT /projects/{id}/env Update env variables
DELETE /projects/{id} Delete project

CLI Commands

devkernel init [name]

Initialize a new DevKernel project in the current directory.

devkernel dev

Start the local development server with hot module replacement.

devkernel build

Build the project for production with optimizations.

devkernel deploy [--prod | --preview]

Deploy the project to production or create a preview deployment.

devkernel env [set | get | list]

Manage environment variables for your project.

devkernel logs [--follow]

View real-time deployment and runtime logs.

Guides

Environment Variables

Environment variables allow you to configure your application without hardcoding sensitive values. DevKernel encrypts all variables at rest and injects them at build and runtime.

$ devkernel env set DATABASE_URL "postgresql://..."
✓ Variable set for all environments
$ devkernel env set API_SECRET "sk-..." --env production
✓ Variable set for production only

Custom Domains

Connect your own domain to any DevKernel project. SSL certificates are automatically provisioned and renewed via Let's Encrypt.

DNS Configuration

Type Name Value
CNAME www cname.devkernel.studio
A @ 76.76.21.21

Monitoring

DevKernel provides built-in monitoring for all your deployments. Track request volume, latency percentiles, error rates, and resource utilization in real-time through the dashboard or API.

Metrics Available

  • • Request volume & throughput
  • • P50 / P95 / P99 latency
  • • Error rates by status code
  • • CPU & memory utilization

Alerting Channels

  • • Email notifications
  • • Slack integration
  • • PagerDuty webhook
  • • Custom webhook URL
Updates

Changelog

v2.4.0

Edge Runtime V2

Introduced V2 of the edge runtime with 40% faster cold starts and Web Streams API support.

v2.3.0

Multi-region Deployments

Deploy to specific regions with the new regions config option.

v2.2.0

AI Code Review

Automated code review powered by LLMs, integrated into the deployment pipeline.

Resources

Examples