Template documentation

Everything you need to understand, customize, and connect Sami Admin.

A thoughtful starting point for support

Sami Admin / TDesk edition

A complete HTML workspace for the people who make customer support feel human. The template combines help desk workflows with reusable forms, components, authentication screens, and utility pages.

Open it. Make it yours.

Every page is ready to open in a browser. All fonts, icons, CSS, and JavaScript are included locally. You can copy this entire folder into your project without installing dependencies.

Open index.html to view the admin workspace. Open front/index.html from the release folder for the customer portal. Each folder is self-contained and can be hosted independently. For consistent demo storage across pages, serve the folder through a static web server.

Built on the existing TDesk design system.

The cobalt palette, speech-bubble mark, Plus Jakarta Sans, pastel surfaces, and directional arrow feedback are shared with the customer portal.

A page for every part of the work

Browse all 33 included HTML pages

Familiar foundations, a distinct workspace

Color, type, rhythm, and shape

Cobalt#2855E8
Ink#172B4D
Mist#F0F4FF
Mint#C5EEDC
Lavender#E8E1FA
Peach#FBE5D6
Paper#FFFFFF
Divider#E3E8F0

Type that feels like TDesk

Plus Jakarta Sans is served locally at weights 400–700. Page titles use 28–32px, section headings 17–20px, body 13–15px, and mobile fields 16px. Keep sentences clear and actions specific.

Space with a purpose

Use the 4px spacing scale, 12px controls, 20px panels, and larger conversation shapes sparingly. White working surfaces sit on a quiet cool canvas. Status is always expressed in text as well as color.

What’s in the download.

admin/
  index.html     Support overview
  *.html         Editable admin pages
  assets/        Styles, scripts, fonts, and images
  vendor/        Local third-party assets and notices

front/
  index.html     Customer help center
  *.html         Editable customer pages
  assets/        Styles, scripts, fonts, and images
  vendor/        Local third-party assets and notices

Edit the HTML, CSS, and JavaScript directly. No install, generator, or build is needed.

Useful interactions, clear boundaries

The browser demo supports ticket creation, replies, assignments, filters, saved drafts, local settings, table exports, form validation, command search, and UI components. These changes stay in this browser under the sami.admin.v1. storage prefix.

Authentication screens validate input and show the next interface state. They do not authenticate users, send email, enforce permissions, or store passwords. Team invitations, SLA policies, and automations are local configuration examples. Attachments are selected locally, not uploaded.

Use sample information while exploring.

This is an HTML template, with no server or shared database. Clearing this browser’s site data restores the initial demo. Reports are a fixed sample dataset rather than measurements of local ticket edits.

Connect the interface to your product

  • Replace browser-local stores with your ticket, customer, article, and workspace APIs.
  • Implement server-side sessions, password hashing, recovery tokens, rate limits, and access enforcement.
  • Validate every request on the server. Client-side validation helps the interface but cannot enforce trust.
  • Sanitize rich content and file uploads, verify file type and size, and store attachments with authorized access.
  • Connect real event data to reports and SLA calculations. Run automation rules on the server.
  • Review email templates, copy, privacy information, and permissions for your product before launch.

Designed to be used, with or without a mouse

Pages include a skip link, semantic landmarks, visible focus rings, labeled controls, inline validation errors, text status labels, native dialogs, and reduced-motion support. Wide tables scroll within their own region and dashboards include readable data summaries.

Use Ctrl + K (or ⌘ + K) for page search. Press Escape to close a dialog or the mobile navigation drawer. The static shell and page content remain readable without JavaScript.

Local libraries and notices

Bootstrap 5.3.8 (MIT), Font Awesome Free 7.3.1 (fonts OFL, code MIT, icons CC BY), and Plus Jakarta Sans (OFL) are included with their license notices. Existing dependency versions are preserved. Ordinary application behavior uses native JavaScript.

The included libraries have their own licenses; retain their notices when distributing your template.