Pluvo course design with AI

Pluvo Course Design

This skill describes how to create consistent, professional-looking content within Pluvo's course environment. It covers two things:

Technical formatting rules that always apply (Pluvo HTML quirks, spacing, typography, images, callouts, structure).
Aesthetic direction — a chosen style that visually ties the entire course together (warm minimalist, editorial, typographic grid, etc.).

Follow these guidelines when writing HTML for edit_content_text or edit_content_embed blocks, or when a user asks for a redesign.

1. Working method — How this skill is applied

Step 1: Determine the scope

Before writing a single line of HTML, get clarity on:

How much are you designing?

A single content block? → ask for the content_id or a description of where it sits
An entire chapter? → walk through all content blocks in that chapter
An entire course? → first map out the course structure, then work chapter by chapter

What's there now?

Read existing content with get_content or get_course_contents_summary
Take stock of what's there: tables, callouts, accordions, images, plain text
Identify what works and what needs the most attention

Step 2: Determine the colour source

Explicitly ask which route is being followed for colours. Three options:

Option A — Academy house style

Fetch the theme colours of the Pluvo course via get_course_theme_colors. Use those as the basis (primary, secondary, accent). Ask whether any additional colours are known from the organisation's house style (logo colours, brand book).

Option B — Own colours in mind

The user has a specific palette in mind or wants to deviate from the academy house style. Ask for concrete colours (hex codes, a brand they admire, or a mood description such as "warm and earthy" or "fresh and blue").

Option C — Choose a default palette

No preference, or no house style known. In that case, offer a choice from predefined palettes (see references/aesthetiek-stijlen.md, section Default colour palettes).

Step 3: Choose an aesthetic direction

Read the details: references/aesthetiek-stijlen.md

Present the user with a choice from the styles. Not just names — describe how it feels in a learning environment:

Style	Feels like...
Warm minimalist	Friendly and approachable. Soft colours, rounded corners, mild shadows. A good default for most e-learning.
Functional	Clean and purposeful. Every element earns its place. No decoration — just clarity. Good for technical or professional content.
Typographic grid	Sturdy and structured. Strong headings, tight grid, flat design. Makes dense information feel organised and authoritative.
Quiet space	Calm and breathable. Lots of whitespace, muted colours, fine lines. Elegant — works for reflective or contemplative content.
Editorial	Typography-driven. Serif headings, pull quotes, thin rules. Makes text-heavy content feel like a well-designed article.
Decorative geometric	Statement piece. Deep colours, geometric precision, decorative frames. Premium feel for leadership content.
Playful graphic	Lively and bold. Bright colours, thick borders, energetic layout. Fun for onboarding, team culture or creative skills.
Raw structural	Unpolished and honest. Monospace, hard edges, no polish. A provocative choice — confirm the user really wants this for learning content.

If the user describes a vibe instead of choosing a style ("I want it

Updated on: 06/05/2026

Was this article helpful?

Thank you!