AnnexCREATE · Index · Tutorials · AnnexHub

AnnexHub – Getting Started (Tutorial)

A hands-on walkthrough ("your first hour with AnnexHub"). Whitepaper format, PDF-ready. Screenshots are captured according to the shot list at the end.

Goal of this Tutorial

By the end your Annex environment is set up: license activated, one suite app installed, your own brand kit created, first assets organized in the library, and a new document started from a template – the foundation for working with all apps of the suite.

Step 1: First Launch and Overview

AnnexHub main window after first launch with onboarding

Launch AnnexHub. On first launch, an onboarding sheet walks you through the basics. The main window follows the suite's three-column layout: the sidebar with eleven areas on the left, content in the middle, and the inspector with status messages and quick help on the right.

Step 2: Activate a License

Licenses area with card grid and license key entry

Switch to the Licenses area (View ▸ Licenses, ⌘2) and redeem your license key online. Each component's status is shown as a card. Without an internet connection, use offline activation: generate an .annex-request file, then read in and apply the offline token.

Step 3: Install a Suite App

Apps area with installation status of the suite apps

Open the Apps area (⌘1). You see all ten suite apps with installation status and version. Install an app from the downloaded archive (.zip or .dmg) into /Applications – or update an already installed app. Open installed apps directly from the list.

Step 4: Create a Brand Kit

Brand kit editor with color palette and font whitelist

In the Brand Kits area, create a new brand kit: define the color palette with color roles (using the harmony generators if needed), set up a font whitelist, and add paragraph and character styles. The brand kit then takes effect suite-wide – for example for titles in AnnexMotion or assets in AnnexCode.

Step 5: Organize Assets in the Library

Library with thumbnail grid and tag filter

Switch to the Library (⌘4) and add your first assets – for example a logo and two images. Assign tags and link the assets to a client or project. Filters and free-text search let you find them again in every app.

Central search with result list and filters

Open Search and enter a term. Search queries the local version index, which the apps fill when saving. Filter by approval status and sort by modification date, title, or version count.

Step 7: New Document from Template

Template catalog grouped by apps with preview

Open "New Document" and pick a template from the catalog – grouped by the other nine apps, with a preview and format hint. AnnexHub creates a real file in the target app's format and launches it directly.

Step 8: Check for Updates and Review Settings

Settings with theme, diagnostics, and server URL

Trigger the update check for all suite apps via AnnexHub ▸ Check for Updates…. In Settings (⌘,), review the theme, diagnostics and privacy options, and the server URL (default http://localhost:8080/v1, adjustable e.g. for a server installation on the LAN).

Result & Next Steps

Your suite is set up: licensed, installed, branded, and filled with first assets. Next, take a look at device management in Licenses (view activated Macs, deactivate remotely), the Plugin Store (⌘5), the Tutorials area (⌘6) with manuals and quick tutorials for all apps, and – for teams – the Teams area with asset and version sync.

All details are in the manual (docs/manuals/en/AnnexHub.md).

Shot List (for Screenshot Capture)

File Content Window State Sample Data
hub-01.png Main window with onboarding sheet Onboarding open over main window First launch, no sample data needed
hub-02.png Licenses area with card grid "Licenses" tab active Demo license status, no real key visible
hub-03.png Apps area with installation status "Apps" tab active Ten suite apps, two marked "installed"
hub-04.png Brand kit editor with palette and fonts "Brand Kits" tab, editor open Brand kit "Café Sonne" with three color roles
hub-05.png Library with thumbnail grid and filters "Library" tab active Demo logo + two images, tags "Logo", "Social"
hub-06.png Central search with results "Search" tab active Search term "Newsletter", two results
hub-07.png Template catalog with preview "New Document" sheet open Template selection for AnnexPublish
hub-08.png Settings with theme and server options "Settings" tab active Default server URL visible