# Vendure Brand Voice Guidelines

This document outlines the Vendure brand's communication style, tone, and patterns to ensure consistency across all content.

## Communication Style

### Overall tone and personality
Vendure's voice is **professional, authoritative, and confident**, yet also **empowering and solution-oriented**. We speak with clarity and precision, focusing on the practical benefits and technical capabilities of our platform. Our tone is direct and factual, avoiding overly casual language or marketing fluff. We aim to be a trusted expert and partner for teams tackling complex commerce challenges.

### Key stylistic elements and patterns
*   **Direct & Concise:** We get straight to the point, using clear and unambiguous language. Sentences are often succinct and impactful.
*   **Benefit-Driven:** Content consistently highlights how Vendure solves specific problems and delivers tangible value, particularly for B2B and complex commerce scenarios.
*   **Empowering Language:** We emphasize the flexibility and extensibility of Vendure, empowering developers and teams to build exactly what they need ("You change what does not fit," "your team extends Vendure in TypeScript").
*   **Structured Information:** We frequently use lists, numbered steps, and clear headings to break down complex information and make it digestible.
*   **Technical but Accessible:** While we use technical terms (APIs, TypeScript, ERP, headless commerce), we ensure their context and benefits are clear, appealing to both technical and business audiences.
*   **Problem-Solution Framing:** Content often sets up a common challenge in complex commerce and positions Vendure as the effective solution.

### Vocabulary preferences and word choices
*   **Keywords:** B2B, commerce, platform, open-source, complex, adaptable, APIs, ERP, developer experience, built-in, scalable, enterprise, governance, operations, integration, headless.
*   **Action-oriented verbs:** Build, connect, explore, move, extend, ship, cut, boost, manage, unify, integrate.
*   **Benefit-oriented adjectives:** Improved, adaptable, unified, leading, powerful, better, complete, robust, flexible.
*   **Avoid:** Jargon without explanation, vague superlatives, overly informal slang.

## Content Patterns

### Common themes and topics
*   **B2B Commerce Solutions:** Addressing the unique complexities of B2B buying (customer-specific pricing, company accounts, approvals).
*   **Platform Features & Capabilities:** Detailed explanations of Vendure's core features and their applications.
*   **Technical Updates & Releases:** Announcing new versions, features, and improvements to the core platform and developer experience.
*   **Developer Empowerment:** Showcasing Vendure's extensibility, open-source nature, and developer-friendly tools.
*   **Customer Success Stories:** Quantifiable examples of how businesses leverage Vendure to achieve significant results.
*   **Industry Guides & Comparisons:** Educational content on commerce trends (e.g., headless commerce) and how Vendure compares to other platforms.

### Structural approaches to content
*   **Introduction of a problem, followed by Vendure's solution.**
*   **Feature spotlights:** Explaining what a feature does, how it works, and its benefits.
*   **Step-by-step workflows:** Illustrating processes (e.g., "Follow one B2B order from sign-in to confirmation").
*   **Numbered lists for key differentiators or benefits:** "Why teams move complex B2B to Vendure."
*   **Categorized blog content:** (Product, Releases, Engineering, Commerce, Company) for easy navigation and topic focus.
*   **Data-backed claims and metrics:** Especially in case studies and feature benefits.

### Call-to-action styles and patterns
CTAs are direct, clear, and action-oriented, often emphasizing a specific benefit or next step.
*   **Direct & Actionable:** "Try Vendure for 14 days," "Start free trial," "Subscribe."
*   **Benefit-focused:** "Explore B2B buying," "Compare plans."
*   **Educational:** "Read the guide," "View documentation."

## Audience Interaction

### How the brand addresses its audience
We address our audience directly using "you" and "your" (e.g., "your team," "your business," "your process"). We assume a certain level of technical and business understanding, positioning ourselves as an expert resource and partner rather than a teacher of basics. We aim to empower them to achieve their goals with Vendure.

### Level of formality and relationship style
The relationship is **professional and respectful**. We maintain a helpful, informative, and expert demeanor. We are not overly formal, but we avoid casual slang or overly familiar language. Our goal is to build trust through competence and clear communication.

### Engagement and conversation patterns
Engagement is primarily achieved by providing valuable, actionable information and solutions. While not highly conversational, we invite engagement through clear calls to action for trials, documentation, and community channels (e.g., GitHub, Discord). We aim to inform and guide rather than entertain.

## Guidelines & Examples

### Do's and don'ts for brand communication

**Do's:**
*   Be direct, clear, and concise.
*   Focus on benefits and solutions, especially for complex B2B scenarios.
*   Use a confident, authoritative, yet empowering tone.
*   Highlight Vendure's extensibility, adaptability, and open-source nature.
*   Use technical terms accurately, explaining their value and impact.
*   Support claims with specific examples, data, or customer stories.
*   Structure content logically with lists, clear headings, and digestible paragraphs.

**Don'ts:**
*   Avoid overly casual, chatty, or informal language.
*   Don't over-simplify technical concepts to the point of inaccuracy.
*   Avoid generic marketing fluff, vague claims, or unsubstantiated superlatives.
*   Don't position Vendure as a rigid, off-the-shelf solution; emphasize its flexibility.
*   Avoid overly aggressive sales language; focus on solving problems and providing value.
*   Don't use jargon without clear context or explanation.

### Example phrases and expressions that are "on-brand"
*   "The ecommerce platform for complex B2B."
*   "Customer-specific pricing, company accounts and approvals on one adaptable platform."
*   "B2B comes built in. They are not workarounds on a platform built for consumer shops."
*   "When your process differs, your team extends Vendure in TypeScript."
*   "Cuts manual work, boosts orders 20%."
*   "Open source at the core."
*   "A monthly digest of product news, customer stories, and engineering deep dives."
*   "Vendure Core v3.8: An MCP Server for Your Store, Improved Security, and More."

### Content types and formats the brand uses
*   **Blog Posts:** Product updates, release announcements, engineering deep dives, commerce guides (e.g., "What Is Headless Commerce?"), company news.
*   **Marketing Copy:** Website landing pages, feature descriptions, solution pages, comparison pages.
*   **Product Descriptions:** Clear, benefit-driven explanations of plans and core features.
*   **Case Studies/Customer Stories:** Detailed narratives of customer success, highlighting challenges, solutions, and quantifiable results.
*   **Documentation:** Technical guides, API references, "how-to" articles.