Installation

Vicket provides a scaffold package to add support pages to your app:

• /support to create tickets
• /ticket?token=... to read and reply to tickets

1. Prepare your website in Vicket

Before embedding support pages:

1. Create or select a website in Dashboard
2. Get the website API key
3. Create at least one ticket template

Without templates, users cannot submit tickets.

2. Generate pages

npx @vicket/create-support --framework next

Supported frameworks:

• next
• nuxt
• react
• vue
• sveltekit

Optional styling mode:

• --styling css
• --styling tailwind

3. Configure environment variables

Next.js

NEXT_PUBLIC_VICKET_API_URL=https://api.vicket.io/api/v1
NEXT_PUBLIC_VICKET_API_KEY=your_website_api_key

Nuxt

NUXT_PUBLIC_VICKET_API_URL=https://api.vicket.io/api/v1
NUXT_PUBLIC_VICKET_API_KEY=your_website_api_key

React / Vue (Vite)

VITE_VICKET_API_URL=https://api.vicket.io/api/v1
VITE_VICKET_API_KEY=your_website_api_key

SvelteKit

PUBLIC_VICKET_API_URL=https://api.vicket.io/api/v1
PUBLIC_VICKET_API_KEY=your_website_api_key

4. Validate

1. Open /support
2. Submit a test ticket
3. Open the ticket link from your notification flow
4. Verify the ticket appears in the dashboard

Security note

Generated templates use direct browser calls with a website-level public support key.

For production, we recommend modifying the generated code to route support calls through your own backend proxy (BFF) instead of calling Vicket directly from the client.

This lets you keep credentials server-side where possible and add abuse protections such as rate limiting, CAPTCHA, and request validation.