Skip to content

Welcome to the new fiskaly Workspace — documentation reimagined.

Learn more

Component Showcase

This is the complete visual reference for the fiskaly design system. Every color token, typographic style, and component available to content authors is documented here with live examples.


The fiskaly color system is built on semantic scales. Every color below is available as a Tailwind utility class (e.g. bg-brand-500, text-gray-900).

The primary brand color, used for CTAs, links, active states, and the fiskaly dot.

50#f0fdfa
100#ccfbf1
200#b2f8ea
300#99f6e4
400#5eead4
500#2dd4bf
600#20c6b2
700#14b8a6
800#129c89
900#11806d
950#042f2e

Used for text, borders, and backgrounds. Tuned for WCAG AA contrast.

50#fcfcfc
100#f6f6f7
200#eff1f3
300#d7dbe1
400#9ca3af
500#6b7280
600#545b6f
700#374151
800#232a30
900#0f181b
950#030712

Secondary informational color, used for info alerts and accent highlights.

50#eff6ff
300#5caeed
500#1264a3
700#1d4ed8
900#053357

Semantic shortcuts for status-driven UI.

Success#2dd4bf
Warning#fddd00
Danger#ff5050
Info#1264a3

These named colors map directly to the scale values above.

Turquoise#2dd4bf (brand-500)
Bunker#0f181b (gray-900)
Athens Gray#eff1f3 (gray-200)
Comet#545b6f (gray-600)

Font family: DM Sans (body & headings), DM Mono (code). Headings use semibold to bold weight with tight tracking.

Regular body text uses DM Sans at a comfortable reading size. Bold text and italic text work as expected. You can combine bold italic too. Here is inline code for API parameters and strikethrough for deprecated items.

Example API Response
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"token_type": "Bearer",
"expires_in": 900
}

The base Card component supports three visual variants and an optional hover flag for interactive states.

Default

Clean background, no border or shadow.

Bordered

Subtle border for visual separation.

Elevated

Shadow for depth and prominence.

Bordered + Hover

Hover over this card to see the interactive shadow and brand-colored border transition.

Cards with an animated gradient border glow on hover. Three color variants available.

Brand Glow

Turquoise gradient border on hover.

Accent Glow

Blue gradient border on hover.

Copper Glow

Warm gradient border on hover.


Feature cards present capabilities with an icon, title, and description. They use GlowCard internally for the premium hover effect.

Navigational cards that point to another page. The arrow animates on hover.


Showcase fiskaly products with an icon, optional badge, and a “Learn more” CTA. Built on GlowCard.

Display market availability with flag, status badge (live | beta | coming-soon), and description.


The base Alert component with four semantic variants: info, success, warning, error.

📘Information

This is an info alert using the accent blue color scheme.

💡Success

This is a success alert using the brand turquoise color scheme.

⚠️Warning

This is a warning alert using the fiskaly yellow color scheme.

🚨Error

This is an error alert using the fiskaly red color scheme.

Semantic aliases that map to Alert variants with default icons: Note (info), Tip (success), Caution (warning), Danger (error).

📘Note

A note callout for general supplementary information. Supports markdown and inline code.

💡Pro Tip

A tip callout for best practices and helpful suggestions.

⚠️Caution

A caution callout for things to watch out for that could cause minor issues.

🚨Danger

A danger callout for critical warnings — data loss, security risks, or breaking changes.


Small inline labels for categorization and status indication. Six variants available.

DefaultBrandSuccessWarningErrorOutline

Buttons come in four variants (primary, secondary, ghost, danger) and three sizes (sm, md, lg). When href is provided they render as anchor tags.


Interactive tab panels for presenting alternative content views. Uses the items prop with label and content fields.

curl -X POST https://kassensichv-middleware.fiskaly.com/api/v2/auth \
  -H "Content-Type: application/json" \
  -d '{"api_key": "test_key", "api_secret": "test_secret"}'

Numbered steps with a connecting gradient line for sequential procedures.

  1. Create your organization

    Sign up at the fiskaly Dashboard and create your organization. You start in the test environment by default.

  2. Generate API credentials

    Navigate to Settings > API Keys and generate your first key pair. Store both values securely.

  3. Initialize your TSS

    Create a Technical Security System using the API. This provisions your cloud-based signing unit.

  4. Start signing transactions

    Begin signing receipts with your configured TSS. Each transaction returns a cryptographic signature.


Animated stat counters with scroll-triggered count-up animation. Props: value (string), label, and optional suffix.

99.9%
Uptime SLA
500M+
Transactions
50K+
Active TSS
3
Countries

Consistent section headers with optional badge pill, subtitle, and align (left or center).

NEW

Section Heading Example

This component provides consistent section headers with optional badges and subtitles.

LAYOUT

Centered Section Heading

The centered variant works well for landing pages and splash sections.

Text with an animated gradient shimmer using fiskaly brand colors. Supports as prop: span, h1, h2, h3, p.

Gradient Text Effect

The animated brand dot with ping effect. The signature element from the fiskaly logo.

SmallMediumLarge

These standard markdown elements are styled by the fiskaly theme CSS.

FeatureStatusVersion
Transaction SigningAvailablev2.0
DSFinV-K ExportAvailablev1.5
Receipt ValidationBetav2.1

“fiskaly provides the simplest cloud-based TSS solution for German fiscal compliance.”

— fiskaly Engineering Team

  • First item with supporting details
  • Second item explaining a concept
  • Third item with a nested list:
    • Nested item A
    • Nested item B
  1. First step in a process
  2. Second step building on the first
  3. Third step to complete the flow

Content above the rule.


Content below the rule.

Use inline code for API parameters like api_key and access_token. Links work as expected: fiskaly Dashboard (external) and back to top (anchor).