Skip to main content

Open Shillinq for the first time

A first look at Shillinq — where the app lives, what the dashboard tells you, and how to tell it is wired up to OpenRegister so the books, invoices, bills, purchase orders, and contracts can load.

Goal​

By the end you will have opened the Shillinq app, recognised the dashboard widgets, and confirmed that the OpenRegister back end is connected.

Prerequisites​

  • A Nextcloud account on an instance where the Shillinq app is installed and enabled.
  • The OpenRegister app installed and enabled — Shillinq stores everything (invoices, bills, purchase orders, contracts, journal entries) in OpenRegister, so it is a hard dependency.
  • The Shillinq register and its schemas imported. An admin runs this once from Settings → Administration → Shillinq (see Manage Shillinq settings).

Steps​

  1. Open the Nextcloud app menu in the top bar and pick Shillinq. You land on the dashboard.

    Shillinq dashboard

  2. Read the dashboard tiles — Open items, Due this week, Completed, Team members. On a fresh install they read sample numbers; they will switch to real counts once the schemas are imported and the first invoices, bills, and contracts flow through.

    Dashboard stat tiles

  3. Open the navigation. Shillinq's navigation is driven by the app manifest — Dashboard at the top, Settings at the bottom. As feature areas land (sales invoicing, accounts payable, procurement, contracts, banking, VAT, reporting) they will appear here as additional menu entries.

    Shillinq navigation

  4. Confirm the OpenRegister link. Go to Settings (the gear in the navigation footer). The page lists the version block, the register configuration, and a save endpoint. If the register field is empty, the link isn't set yet — fix that next (see Manage Shillinq settings).

    Settings page with OpenRegister link

Verification​

You are set up correctly when: the Shillinq dashboard renders without an error banner, the navigation lists Dashboard and Settings, the settings page shows a non-empty Register value, and OpenRegister is reachable.

Common issues​

SymptomFix
"OpenRegister is not installed or enabled" bannerInstall and enable the OpenRegister app, then reload Shillinq.
Dashboard tiles still show sample countsThe first invoices/bills/etc. haven't flowed through yet, or the schemas aren't mapped — see the settings page.
Shillinq is missing from the app menuThe app is not enabled for your account — ask an administrator to enable it (and check it is not restricted to a group you are not in).
Screenshots may be missingApp not yet installed in the test environment; rerun npm run test:e2e:docs once it is.

Reference​