Skip to content
Taprel
Docs menu Going live

Going live

Your customers' PCs, the two questions they answer, and a plan for your website.

Each PC that prints needs the Taprel app, and your website needs a plan.

1Install the app on each PC

Send your customers the same download as yours: the latest release, the file ending in _x64-setup.exe. It installs for the Windows user with no admin rights, starts with the computer, runs in the tray and updates itself.

Then, on the app’s Printers page, check each printer’s type and paper. See Printers.

2The two questions

The first time your website prints, the person at the computer answers two questions, once:

Who asks The question
The browser, on a real website (never on localhost) “Access other apps and services on this device”
The Taprel app, in a small window in the middle of the screen “Allow this website to print?”

They come with the first request, or with connect(), so you can call connect() at a moment that makes sense, like when the customer opens your printing settings. Show them what to click:

import { browserPermissionTexts } from "@taprel/sdk";
import { printer } from "./printer";

printer.onStatusChange((status, error) => {
  if (status === "waiting-for-browser") show(browserPermissionTexts.beforeQuestion);
  else if (status === "waiting-for-agent") show('Answer "Allow this website to print?" on your screen.');
  else if (error?.code === "BROWSER_BLOCKED") show(browserPermissionTexts.afterBlock);
  else show(error?.message ?? "");
});

PrintHelp shows the right words while a question waits or when something is wrong, and nothing when all is well. In Brave, ask your customers to set Remember my decision to forever, or Brave asks again on the next visit.

3Put your domain on a plan

Create your Taprel account and add your domain on the Domains page. That starts a 14-day trial with no card, and its subdomains print too. Subscribe on the Billing page before it ends, or printing stops.

Plan Monthly Yearly Includes
Starter $9 $90 1 domain, 5 computers
Pro $29 $290 Unlimited domains, 50 computers

On your own computer, localhost is free with no account, up to 50 print jobs a day. A new domain or plan works within a minute.

More

Plans and billing
  • An account gets one trial, and a domain only ever gets one. A domain that already had a trial can still be added, with no free days.
  • A yearly plan costs the same as ten months, with the same limits.
  • Prices are in US dollars. Paddle takes the payment, and adds or includes tax depending on your country. Change plan, update your card or cancel on the Billing page.
  • The Taprel app itself is free: a plan is for printing from websites.
  • A computer counts when it first prints for a domain on your account. Removing it on the Computers page frees its place.
  • Need more than 50 computers? Email us. Your price stays the same as long as you stay subscribed.
For an agency

The account is whoever pays: you, for your customers’ websites, or a business, for its own. One account can hold all your customers’ domains, and their PCs count as its computers. A trial and Starter cover one domain, so for several customers, choose Pro.

How domains are matched
  • A listed domain also covers its subdomains, so shop.com covers a.shop.com. For order.cafe.example, list cafe.example or order.cafe.example.
  • The scheme and port don’t count.
  • Public endings like vercel.app can’t be listed. List your own address on them instead, like one.vercel.app.
Local addresses, and more than 50 jobs on localhost

Addresses like 192.168.1.10, and localhost past the free limit, need the computer linked to an account on its trial or a paid plan, because they don’t say whose they are.

  1. In the Taprel app, open Settings, go to Taprel account and click Show code.
  2. Type the code on your account’s Computers page. It lasts 15 minutes.

Printing starts within a minute. When the trial ends with no plan, these addresses stop printing until you choose one.

If someone says no
  • Block, in the browser, gives BROWSER_BLOCKED. The package stops trying. browserPermissionTexts.afterBlock says how to change it.
  • Don’t allow, in the app, gives ORIGIN_NOT_ALLOWED, and the app remembers it. Removing the website on the app’s Websites page lets it ask again.
  • Closing the app’s window, or not answering within 2 minutes, refuses this time only, with the same ORIGIN_NOT_ALLOWED. The next request asks again, with no reload needed.

The app treats each exact address as its own website, so http:// and https://, or another port, ask again.

If your site has a Content-Security-Policy

Add ws://127.0.0.1:21873 to connect-src, or you get the CONTENT_SECURITY_POLICY error.

When a payment fails, or our server can’t be reached
  • A failed payment, an ended plan or too many computers starts 14 days of warnings. Printing goes on, and we email you. After that, printing stops with LICENSE_REQUIRED.
  • If our server can’t be reached, the app keeps using its last answer for up to 30 days. With no usable answer, a job gets LICENSE_UNAVAILABLE, and trying again later can work.
About the app
  • Updates: it looks for a new version 30 seconds after it starts, then every 6 hours, and installs it when no job is printing.
  • What it keeps: its settings, the websites it allowed or refused, and the last 200 jobs, on its Activity page.
  • Its guide shows again from Show the welcome guide in Settings.
  • Uninstall: in Windows’ Settings, open Apps, find Taprel and choose Uninstall.
What the app sends us

To check the licence, the app sends the website’s address, a random computer ID, its version, and daily job and failure counts per website, and our server sees its IP address. It never sends what you print.