IntroVox Documentation

Welcome to the IntroVox documentation. IntroVox is a Nextcloud app that provides an interactive onboarding tour for new users — built with Vue 3 and Shepherd.js, with multi-language support, group-based step visibility, and a full admin configuration interface.

A step-by-step guided tour through Nextcloud's main features, fully customizable per language.

Quick Navigation

For Users

Learn how to take, restart, and configure your tour preferences.

• Overview — What IntroVox is and how the tour works
• Taking the Tour — Navigating steps, highlighted elements, centered vs. attached
• Personal Settings — Restart, permanently disable, language messages
• Keyboard Navigation — Shortcuts and accessibility features
• Mobile Experience — Responsive layout, touch interactions
• Troubleshooting — Tour not starting, missing steps, language issues
• FAQ — Common user questions
• Tips — Getting the most out of Nextcloud

For Administrators

Installation, configuration, step management, and operations.

• Admin Guide — Day-to-day administration
• Settings — Admin panel reference
• Language Management — Enable/disable languages, per-language configuration
• Managing Wizard Steps — CRUD, reordering, enable/disable, reset to default
• Group-Based Visibility — Role-based onboarding with group filters
• Import/Export — Share configurations between instances
• Best Practices — Content guidelines, language strategy, maintenance
• Troubleshooting — Wizard not showing, missing steps, translations
• FAQ — Common admin questions

Features

Per-feature documentation for capabilities.

• Guided Tours — Shepherd.js engine, step types, attached vs. centered
• Multi-Language Support — Transifex integration, auto-detection, per-language steps
• Step Visibility — Group filters + user preferences
• Customization — HTML in step content, CSS selectors, positioning
• Theme Support — Light, dark, high contrast, custom Nextcloud themes

For Architects & Developers

Technical documentation for integration, evaluation, and contribution.

• Architecture Overview — System design and components
• API Reference — REST API endpoints
• Frontend Architecture — Vue 3 + Shepherd.js structure
• Backend Architecture — Controllers, services, config storage
• Transifex Integration — Translation workflow

Deployment

Installation, App Store submission, and release process.

• Installation — Install from App Store or source
• App Store Submission — Certificate, packaging, signing, uploading
• Release Process — Version sync, build, GitHub releases

Getting Started

New to IntroVox? Start with the Getting Started Guide for a per-role quickstart.

Support

• Issues & Feature Requests: GitHub Issues
• Source Code: GitHub Repository

License

IntroVox is licensed under the AGPL-3.0 License.