@ui-guide-agent/web weekly downloads statistics

@ui-guide-agent/web

An AI help agent in your web application. No .NET needed. Your users ask "how do I…?" and get concrete steps: which button to press and which page to open. The answer is in the language of the question and starts from the page the user is on.

Privacy: the page is read the way a screen reader reads it: roles, labels and states. Never field values, passwords, or the contents of lists and tables.

Quick start

1. Install the package: 2. Add the line for your framework:

| Framework | What to add |

| Vite (React, Vue, Svelte, Solid…), SvelteKit | In vite.config: import uiGuide from '@ui-guide-agent/web/vite' and plugins: [uiGuide()] | | Astro | In astro.config: import uiGuide from '@ui-guide-agent/web/astro' and integrations: [uiGuide()] | | Nuxt | In nuxt.config: modules: ['@ui-guide-agent/web/nuxt'] | | webpack 5 or Rspack | import { UiGuidePlugin } from '@ui-guide-agent/web/webpack' and plugins: [new UiGuidePlugin()] | | Next.js | In next.config.mjs: export default withUiGuide(nextConfig) (from @ui-guide-agent/web/next). In instrumentation-client.ts: import '@ui-guide-agent/web/auto'; | | Angular CLI | In package.json: "prestart": "uiguide prepare" and "prebuild": "uiguide prepare --release". In src/main.ts: import '@ui-guide-agent/web/auto'; |

1. Build or start your development server. Every build then: • writes uiguide.json and the configuration your page reads; • generates the knowledge bundle; • puts the assistant in every page; • shows the warning UIG001 for every control without a name.

Until the assistant has a server, it answers "not configured yet" and the build shows the warning UIG003. 4. Connect a server, then rebuild: • On your computer: dotnet tool install -g UiGuideAgent.Server.Host, then uiguide-server. The next build finds it and registers your application with your development address. • Your company's server: npx uiguide init --server https://… in your project folder.

The build for your users (vite build, next build…) leaves the address of your computer out.

Good to know

• Name controls the browser way: aria-label, a or a around the field, the button's text. • The language: the assistant follows the language your page shows. The answer is in the language of the question. • From code: import { setContext, setToken, setLanguage } from '@ui-guide-agent/web'. • Update: the build tells you (warning UIG002). Run npm install -D @ui-guide-agent/web@latest. • Remove: run npx uiguide remove in your project folder. It shows what it removes and asks first.

Full guide: https://github.com/DomitorAI/ui-guide-agent/blob/main/docs/web.md

Free to use without limits, also commercially. You may ship it, unmodified, inside your own application, also one you sell. Selling UiGuide Agent itself, or offering it as a paid hosted service, needs the author's permission. Provided as is, without warranty. https://github.com/DomitorAI/ui-guide-agent