@fronti/core 1.0.0 → 1.0.3

package/README.md

@@ -0,0 +1,142 @@
+# Fronti - Visual Layer for Claude Code
+
+Fronti brings Claude Code's powerful agent capabilities into your browser. Point it at any localhost project, select the element you want to change, describe what you need, and Claude updates your codebase instantly.
+
+- Visual interface for Claude Code running on your localhost
+- Works with React, Next.js, Vue, Tailwind, Astro, Svelte, and any web stack
+- Handles UI changes, refactors, API integrations, logic updates, and test generation
+- Perfect for rapid prototyping and production refinements
+
+[![npm version](https://img.shields.io/npm/v/@fronti/core?label=@fronti/core)](https://www.npmjs.com/package/@fronti/core)
+[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/jojjbmgmggenijlkhjeaiodfoggjcjgj?label=Chrome%20Extension)](https://chromewebstore.google.com/detail/visual-editor-ai/jojjbmgmggenijlkhjeaiodfoggjcjgj)
+[![GitHub stars](https://img.shields.io/github/stars/waspdev95/fronti?style=social)](https://github.com/waspdev95/fronti/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Quick start
+
+1. Install the Chrome extension
+   [Fronti Chrome Extension](https://chromewebstore.google.com/detail/visual-editor-ai/jojjbmgmggenijlkhjeaiodfoggjcjgj)
+
+2. Install Fronti Core
+   `npm install -g @fronti/core`
+
+3. Install Claude Code CLI
+   `npm install -g @anthropic-ai/claude-code`
+
+4. Start your project
+   - Open your project in your editor
+   - Start your local development server (e.g., `npm run dev` → `http://localhost:3000`)
+
+5. Edit visually
+   - Launch the Chrome extension, select an element, describe the change, and let Claude apply it to your codebase
+
+---
+
+## What you can do
+
+- Redesign components, restyle layouts, and update content directly from your browser
+- Refactor logic, connect APIs, adjust data flows, and generate tests using Claude's agent capabilities
+- Create new sections and reusable components with production-ready code
+- Apply batch improvements like accessibility fixes, theme updates, or design token changes across your entire project
+- See changes instantly with your existing dev server and hot reload
+
+---
+
+## Why Fronti?
+
+Get the speed of hosted AI tools with complete control over your codebase.
+
+| Feature | Hosted AI Builders | Fronti |
+| --- | --- | --- |
+| Works with your existing codebase | No | Yes |
+| Code stays on your machine | No | Yes |
+| Visual click-to-edit interface | Limited | Yes |
+| Full agent capabilities | No | Yes |
+
+---
+
+## How it works
+
+- The Chrome extension provides a visual interface over your localhost dev server
+- The `@fronti/core` package connects your browser to Claude Code CLI
+- Claude executes changes locally in your codebase
+
+---
+
+## Built for web development
+
+- Turn visual feedback into code changes in minutes
+- Works with any framework or design system
+- Everything runs locally on your machine
+
+---
+
+## Requirements
+
+- Node.js 18 or newer
+- Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
+- Fronti Core (`npm install -g @fronti/core`)
+- Fronti Chrome Extension
+- Chromium-based browser (Chrome, Edge, Arc, etc.)
+- Local dev server running your project
+
+All Claude requests run through Claude Code CLI, which requires an active Anthropic subscription.
+
+---
+
+## Development
+
+Build each extension independently when working from source.
+
+### Chrome extension
+
+```bash
+cd chrome-extension
+npm install
+npm run build
+```
+
+Load the unpacked extension from `chrome-extension/dist` in Chrome.
+
+### VS Code extension
+
+```bash
+cd vsc-extension
+npm install
+npm run compile
+npm run package  # Outputs visual-editor-ai-<version>.vsix in vsc-extension/
+```
+
+Install the generated `.vsix` in VS Code (Extensions panel -> ... -> Install from VSIX).
+
+---
+
+## Contributing
+
+Contributions are welcome:
+
+1. Fork this repository.
+2. Create a feature branch (`git checkout -b feature/my-improvement`).
+3. Commit your changes (`git commit -m "Describe your change"`).
+4. Push the branch and open a pull request.
+
+---
+
+## License
+
+Fronti is distributed under the [MIT License](LICENSE).
+
+---
+
+## Support
+
+If Fronti helps your workflow, please star the repo and share feedback.
+
+- [Report bugs](https://github.com/waspdev95/fronti/issues)
+- [Start a discussion](https://github.com/waspdev95/fronti/discussions)
+
+---
+
+<p align="center">Made with care for developers.</p>

package/dist/runtime.js

@@ -36,17 +36,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureRuntimeFiles = ensureRuntimeFiles;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const HOST_JS_CONTENT = `#!/usr/bin/env node
-const { runNativeHost } = require('@fronti/native-host');
-
-runNativeHost();
+const HOST_JS_CONTENT = `#!/usr/bin/env node
+const { runNativeHost } = require('@fronti/native-host');
+
+runNativeHost();
 `;
-const HOST_BAT_CONTENT = `@echo off
-node "%~dp0host.js" %*
+const HOST_BAT_CONTENT = `@echo off
+node "%~dp0host.js" %*
 `;
-const HOST_SH_CONTENT = `#!/usr/bin/env bash
-DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
-node "\${DIR}/host.js"
+const HOST_SH_CONTENT = `#!/usr/bin/env bash
+DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+node "\${DIR}/host.js"
 `;
 function ensureRuntimeFiles(targetDir, platform) {
     if (!fs.existsSync(targetDir)) {

package/package.json

@@ -1,36 +1,39 @@
-{
-  "name": "@fronti/core",
-  "version": "1.0.0",
-  "description": "Core bridge component for Fronti - connects browser, VS Code, and Claude Code.",
-  "type": "commonjs",
-  "main": "dist/index.js",
-  "bin": {
-    "fronti-core": "dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc -p ./tsconfig.json",
-    "clean": "rimraf dist",
-    "prepare": "npm run build",
-    "postinstall": "node ./dist/cli.js auto-install || true"
-  },
-  "keywords": [
-    "fronti",
-    "native-messaging",
-    "claude",
-    "chrome"
-  ],
-  "author": "Fronti",
-  "license": "MIT",
-  "dependencies": {
-    "yargs": "^17.7.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.16.11",
-    "@types/yargs": "^17.0.33",
-    "rimraf": "^5.0.10",
-    "typescript": "^5.6.3"
-  }
-}
+{
+  "name": "@fronti/core",
+  "version": "1.0.3",
+  "description": "Visual-first AI coding agent for local codebases. Select elements in browser, describe changes, agent applies edits.",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "bin": {
+    "fronti-core": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "runtime/host.bat",
+    "runtime/host.js",
+    "runtime/host.sh"
+  ],
+  "scripts": {
+    "build": "tsc -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "prepare": "npm run build",
+    "postinstall": "node ./dist/cli.js auto-install || true"
+  },
+  "keywords": [
+    "fronti",
+    "native-messaging",
+    "claude",
+    "chrome"
+  ],
+  "author": "Fronti",
+  "license": "MIT",
+  "dependencies": {
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.16.11",
+    "@types/yargs": "^17.0.33",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.6.3"
+  }
+}

package/runtime/host.bat

@@ -0,0 +1,2 @@
+@echo off
+node "%~dp0host.js" %*

package/runtime/host.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const { runNativeHost } = require('@fronti/native-host');
+
+runNativeHost();

package/runtime/host.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+node "${DIR}/host.js"