🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →
Sign In

@dotuix/ai

Package Overview
Dependencies
Maintainers
1
Versions
6
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@dotuix/ai

One-function SDK for creating .uix files from AI-generated code

latest
Source
npmnpm
Version
0.1.5
Version published
Maintainers
1
Created
Source

@dotuix/ai

One-function SDK for creating .uix files from AI-generated code.

npm install @dotuix/ai

For AI agents using tool calls, use @dotuix/mcp instead. This package is for AI-generated Node.js / TypeScript scripts that build .uix files programmatically.

Usage

import { createUIX } from "@dotuix/ai";

const path = await createUIX({
  manifest: {
    uix: "1.0",
    id: "com.example.myapp",
    name: "My App",
    version: "1.0.0",
    entry: "index.html",
    mode: "window",
  },
  files: {
    "index.html": `<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>My App</title></head>
<body>
  <h1>Hello from .uix</h1>
  <script src="app.js"></script>
</body>
</html>`,
    "app.js": `(async () => {
  const manifest = await uix.manifest();
  document.querySelector('h1').textContent = manifest.name;
})();`,
  },
});

console.log(path); // /tmp/dotuix-xxx/my-app.uix — ready to open in the viewer

That's it. createUIX handles:

  • Creating a temp directory and project structure
  • Writing your files to disk
  • Auto-stamping ai.generatedBy and ai.generatedAt in the manifest
  • Calling dotuix pack to produce the .uix file
  • Cleaning up the source directory

API

createUIX(options: CreateUIXOptions): Promise<string>

Returns the absolute path to the packed .uix file.

CreateUIXOptions

FieldTypeRequiredDescription
manifestRecord<string, unknown>Yesmanifest.json content. The ai block is merged and stamped automatically.
filesRecord<string, string>YesSource files as { "relative/path": "utf-8 content" }. Do not include manifest.json.
outputstringNoAbsolute path for the output .uix file. Defaults to a temp directory.
generatedBystringNoOverrides ai.generatedBy. Defaults to "@dotuix/ai".

The ai provenance block

Every .uix created via createUIX gets an ai block stamped in its manifest.json:

{
  "ai": {
    "generatedBy": "@dotuix/ai",
    "generatedAt": "2026-05-19T12:00:00Z"
  }
}

Pass capabilities in your manifest to declare what the app does:

manifest: {
  // ...
  ai: {
    capabilities: ["search", "chat"],
  },
},

The final manifest will have generatedBy and generatedAt merged in.

When to use which package

ScenarioUse
Talking to Claude Desktop / Cursor / Copilot@dotuix/mcp
AI writes a Node.js script that creates a .uix@dotuix/ai
Packing a manually written app@dotuix/cli (dotuix pack)
Programmatic pack/unpack/validate in any context@dotuix/core

Requirements

  • Node.js ≥ 22
  • @dotuix/cli installed globally: npm install -g @dotuix/cli

Links

Keywords

uix
dotuix
ai
llm
code-generation
portable

FAQs

Package last updated on 11 Jun 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

AWS Security Hub Adds Socket for Supply Chain Security

Company News

AWS Security Hub Adds Socket for Supply Chain Security

Socket is now in the AWS Security Hub Extended plan. Adopt it through AWS, apply committed spend, and block malicious open source packages.

By Feross Aboukhadijeh  -  Aug 04, 2026