Autogram na webe — monorepo 🇸🇰

Tento repozitár obsahuje zdrojový kód dvoch spolu súvisiacich projektov okolo Autogramu — aplikácie na elektronické podpisovanie dokumentov:

• Rozšírenie "Autogram na štátnych weboch" — rozšírenie do prehliadača, ktoré na vybraných štátnych weboch (napr. slovensko.sk a portál Finančnej správy) nahrádza starý podpisovač DSigner za Autogram alebo Autogram v Mobile. Vďaka nemu podpíšete dokumenty na štátnych portáloch napríklad aj cez mobil.
• Autogram SDK — knižnica pre tvorcov webových stránok, ktorá umožňuje pridať podpisovanie Autogramom (na počítači aj v mobile) do vlastnej webovej aplikácie.

Ak si chcete iba nainštalovať rozšírenie do prehliadača, nepotrebujete nič z tohto repozitára — stačí ho pridať zo store vášho prehliadača, odkazy nájdete v návode na inštaláciu.

Autogram on the web — monorepo (en)

This repository contains the source code of two related projects built around Autogram, an application for electronic document signing:

• "Autogram on Government Websites" extension — a browser extension that replaces the legacy DSigner component with Autogram or Autogram v Mobile on selected Slovak government websites (e.g. slovensko.sk and the Financial Administration portal), so you can sign documents there without installing outdated software.
• Autogram SDK — a library for web developers that adds Autogram signing (desktop and mobile) to their own web applications, including a ready-made dialog for choosing the signing method.

If you just want to use the extension, you don't need anything from this repository — install it from your browser's extension store, see the installation guide.

---

Development

This is a monorepo using npm workspaces with Turborepo task orchestration:

• /autogram-sdk — SDK package
• /autogram-extension — extension package (depends on the SDK)

Turborepo resolves package task dependencies, so running extension build tasks from the root will automatically build the SDK first.

Prerequisites

• Node.js 24 LTS (pinned in .nvmrc, also used by CI; run nvm use). Node 22.12+ also works, older versions are not supported by Vite.
• npm (comes with Node.js)

Installation

npm install

This will install dependencies for all packages. It does not build the SDK: root npm run build* tasks build it first automatically (via Turborepo), but if you consume autogram-sdk/dist directly, run npm run build:sdk first.

Common tasks

npm run build              # build all packages
npm run build:sdk          # build the SDK only
npm run build:extension    # build the extension only
npm run build:dev          # development build of the extension
npm start                  # start the development server
npm test                   # run tests
npm run lint               # lint code
npm run typecheck          # type checking
npm run clean              # clean build artifacts

Development workflow (VS Code)

1. Run npm run watch:mv3. It builds the SDK, then rebuilds the MV3 extension into autogram-extension/dist on every change.
2. In VS Code, start the Launch Chrome against example-extension-usage debug configuration (F5). It serves the example page on http://localhost:49675/ and opens Chrome with the extension from autogram-extension/dist loaded.

After a rebuild, reload the extension in chrome://extensions (or restart the debug session) to pick up changes.

Example apps

npm run example-extension-usage
npm run example-avm-integration

Package documentation

See the individual package READMEs for package-specific documentation:

• autogram-sdk/README.md
• autogram-extension/README.md

Generated autogram-sdk API reference is published to GitHub Pages: https://slovensko-digital.github.io/autogram-extension/autogram-sdk/

License

EUPL-1.2 — see the LICENSE file in each package (autogram-sdk, autogram-extension) for details.