HeroPrompt Web UI

A clean web interface for creating and managing AI prompts with file and workspace management.

Overview

HeroPrompt provides a VS Code–style interface to browse files, organize workspaces, and generate AI prompts. It combines a modern UI with intelligent file handling and flexible prompt generation.

Features

• 🎨 Modern UI: Light/dark themes, responsive layout, smooth animations
• 📁 Workspaces: Create, update, delete, and persist workspaces
• 🗂️ File Explorer: Tree view, filtering, expand/collapse, multi-select
• 🔍 Preview: Card-based file previews with metadata and syntax highlighting
• 🚀 Prompt Generation: Build structured AI prompts from selected files

Usage

./cli/compile.vsh   ##./hero web          ##

• Create a workspace → select files → preview → generate prompts
• Manage workspaces (create, update, delete) via UI

fn detect_lang(path string) string

Language detection utility for code files

fn get_default_menu() []MenuItem

Default menu for the Admin UI. Used when no custom menu is provided.

fn menu_html(items []MenuItem, depth int, prefix string) string

Recursive menu renderer

fn new(args FactoryArgs) !&App

fn render_chat_alt(app &App) !string

fn render_heroprompt_page(app &App) !string

Render the Heroprompt admin page using feature template

fn render_heroscript_alt(app &App) !string

Render HeroScript page

fn start(args FactoryArgs) !

Start the webserver (blocking)

struct App {
	veb.StaticHandler
pub mut:
	title string
	menu  []MenuItem
	port  int
}

The App holds server state and config

fn (app &App) admin_index(mut ctx Context) veb.Result

Admin home page

fn (app &App) admin_section(mut ctx Context, path string) veb.Result

Catch-all content under /admin/*

fn (app &App) api_heroprompt_add_dir(mut ctx Context, name string) veb.Result

fn (app &App) api_heroprompt_add_file(mut ctx Context, name string) veb.Result

fn (app &App) api_heroprompt_delete(mut ctx Context, name string) veb.Result

Delete endpoint using POST (VEB framework compatibility)

fn (app &App) api_heroprompt_directory(mut ctx Context) veb.Result

fn (app &App) api_heroprompt_file(mut ctx Context) veb.Result

fn (app &App) api_heroprompt_generate_prompt(mut ctx Context, name string) veb.Result

fn (app &App) api_heroprompt_get(mut ctx Context, name string) veb.Result

wsp := hp.get(name: name, create: true, path: base_path) or { return ctx.text(json_error('create failed')) } ctx.set_content_type('application/json') return ctx.text(json.encode({ 'name': wsp.name 'base_path': wsp.base_path })) }

fn (app &App) api_heroprompt_list(mut ctx Context) veb.Result

APIs

fn (app &App) api_heroprompt_search(mut ctx Context, name string) veb.Result

fn (app &App) api_heroprompt_sync_selection(mut ctx Context, name string) veb.Result

fn (app &App) api_heroprompt_update(mut ctx Context, name string) veb.Result

fn (app &App) api_test(mut ctx Context) veb.Result

Test API endpoint to verify routing works

fn (app &App) root(mut ctx Context) veb.Result

Redirect root to /admin

fn (app &App) serve_colors_css(mut ctx Context) veb.Result

Serve shared static assets (colors.css, main.css, theme.js)

fn (app &App) serve_main_css(mut ctx Context) veb.Result

fn (app &App) serve_theme_js(mut ctx Context) veb.Result

struct Context {
	veb.Context
}

Public Context type for veb

struct FactoryArgs {
pub mut:
	name  string = 'default'
	host  string = 'localhost'
	port  int    = 9999
	title string = 'Admin'
	menu  []MenuItem
	open  bool
}

Factory args

struct MenuItem {
pub:
	title    string
	href     string
	children []MenuItem
}

Simple tree menu structure