Analytics Enablement Toolkit

Reusable building blocks for analytics presentations, training material, architecture walkthroughs, ways-of-working sessions, and technical documentation.

This repo is designed for people who want to create presentation material in Markdown using Slidev, while keeping the content easy to version, review, copy, and improve over time.

What this is

A small toolkit for creating reusable analytics enablement material.

Use it for:

• Power BI training decks
• Analytics ways-of-working
• Semantic model guidelines
• Data platform architecture walkthroughs
• Community of Practice sessions
• GitHub / CI-CD / deployment explanations
• Markdown-based documentation
• Reusable diagrams, checklists, and examples

What this is not

This repo should not contain:

• Production reports
• Real business data
• Secrets, credentials, or tokens
• Environment-specific production configuration
• Large exported files that can be regenerated

Repo structure

analytics_enablement_toolkit/
│
├─ slides.md                         # Demo/start deck that runs immediately
├─ package.json                      # Slidev commands and dependencies
│
├─ brand/
│  ├─ brand.yml                      # Active brand colors and labels
│  └─ brand.template.yml             # Copy when creating a new company brand
│
├─ styles/
│  ├─ index.css                      # Main Slidev CSS entry
│  └─ generated-brand.css            # Generated from brand/brand.yml
│
├─ components/                       # Reusable Vue components for slides
├─ layouts/                          # Reusable custom Slidev layouts
│
├─ blocks/                           # Copy/paste-ready Markdown slide blocks
│  ├─ agenda/
│  ├─ principles/
│  ├─ architecture/
│  ├─ dax/
│  ├─ power-query/
│  ├─ github-actions/
│  └─ checklists/
│
├─ templates/                        # Starter decks for different session types
│  ├─ training-deck/
│  ├─ cop-session/
│  └─ architecture-walkthrough/
│
├─ decks/                            # Suggested folder for your real decks
│
├─ docs/
│  ├─ 01_quickstart_explained_for_a_47_year_old_5_year_old.md
│  ├─ 02_working_with_markdown.md
│  ├─ 03_how_to_work_with_slidev_decks.md
│  ├─ 04_branding_and_company_colors.md
│  └─ 05_recommended_workflow.md
│
└─ scripts/
   ├─ apply-brand.mjs                # Generates CSS variables from brand.yml
   ├─ create-deck.ps1                # Create a new deck from a template
   └─ create-deck.sh                 # Create a new deck from a template

Prerequisites

Install:

1. Node.js 18 or later
2. Git
3. VS Code

Recommended VS Code extensions are listed in .vscode/extensions.json.

Quick start

From the repo root:

npm install
npm run brand
npm run dev

Then open the local Slidev URL shown in the terminal.

Usually it is:

http://localhost:3030/

Create a new deck

PowerShell:

./scripts/create-deck.ps1 -Template training-deck -Name power-bi-development-standards

Bash:

./scripts/create-deck.sh training-deck power-bi-development-standards

Then run:

npm run dev -- decks/power-bi-development-standards/slides.md

Change company colors

Edit:

brand/brand.yml

Then run:

npm run brand

This regenerates:

styles/generated-brand.css

The CSS variables are used by layouts and components.

Recommended KISS workflow

1. Start from a template.
2. Copy in blocks from blocks/.
3. Keep one main idea per slide.
4. Use Mermaid for architecture diagrams.
5. Use code blocks for DAX, M, SQL, YAML, and PowerShell.
6. Export PDF when the deck needs to be shared.
7. Keep the Markdown source as the real source of truth.

Useful commands

npm run dev
npm run build
npm run export
npm run export:pptx
npm run brand

Naming suggestion

Deck folders should use lowercase kebab-case:

power-bi-development-standards
semantic-model-design-basics
analytics-platform-overview
github-actions-deployment-flow

Guiding principle

A deck should be easy to:

• understand
• reuse
• review
• version
• present
• export