Features Overview

This section covers advanced features in Nuxt Crouton. Each feature has a stability status indicating its readiness for production use.

Stability Status

All features in this section are labeled with their current stability status:

Available Features

1. Internationalization (i18n)

File: 1.internationalization.md | Status: Stable ✅

Multi-language support for your Nuxt Crouton applications:

• Translatable fields in collections
• Language switching UI
• Translation management interface
• Fallback language support
• Integration with Nuxt i18n module

Use case: Multi-language applications, global products, localized content

2. Rich Text Editor

File: 6.rich-text.md | Status: Beta 🔬

Rich text editing capabilities:

• WYSIWYG editor integration
• Markdown support
• Custom formatting options
• Image embedding
• Code blocks and syntax highlighting

Use case: Blog posts, documentation, content management systems

3. Assets & File Management

File: 7.assets.md | Status: Experimental ⚠️

File upload and asset management:

• File upload fields
• Image optimization
• Asset storage (local, cloud)
• File type validation
• Asset gallery views

Use case: Image galleries, document management, media libraries

Note: API may change in future releases. Use storage adapters for production.

4. AI Integration

File: 13.ai.md | Status: Stable ✅

AI chat and completion capabilities:

• useChat() composable for streaming conversations
• useCompletion() for text generation
• AIChatbox, AIMessage, AIInput components
• Multi-provider support (OpenAI, Anthropic)
• Server-side provider factory
• Chat conversation persistence schema

Use case: AI assistants, chatbots, content generation, code assistants

5. Events System

File: 9.events.md | Status: Experimental ⚠️

Event-driven architecture for collections:

• Lifecycle hooks (beforeCreate, afterUpdate, etc.)
• Custom event handlers
• Event bus integration
• Webhooks support
• Real-time updates

Use case: Audit logging, notifications, data synchronization, workflow automation

Note: API under active development. Event patterns may change.

6. Maps Integration

File: 10.maps.md | Status: Beta 🔬

Location and map features:

• Map field types
• Location picker UI
• Geocoding support
• Map providers (Leaflet, Mapbox, Google Maps)
• Custom map styles

Use case: Store locators, delivery tracking, location-based services

7. DevTools

File: 11.devtools.md | Status: Beta 🔬

Enhanced development experience:

• Collection inspector
• Schema validator
• Generated code viewer
• Performance profiler
• Database query inspector

Use case: Debugging, optimization, understanding generated code

8. Flow Visualization

File: 12.flow.md | Status: Beta 🔬

Interactive graph visualization with real-time collaboration:

• DAG/tree visualization with Vue Flow
• Drag-and-drop node positioning with persistence
• Real-time multiplayer sync (Yjs + Durable Objects)
• Presence indicators (cursors, selections)
• Custom node components per collection
• Auto-layout with Dagre

Use case: Workflow builders, decision trees, entity relationships, collaborative editing

Note: Sync mode requires Cloudflare Durable Objects infrastructure.

9. Data Export

File: 15.export.md | Status: Stable ✅

Export collection data to CSV and JSON formats:

• CSV and JSON export formats
• Custom field selection and labeling
• Field and row transformations
• Server-side query exports
• Ready-to-use export button component
• i18n support for labels

Use case: Reporting, data backups, data migration, audit exports

10. Admin Dashboard

File: 14.admin.md | Status: Stable ✅

Super admin dashboard for system-wide management:

• User management (list, create, ban, unban, delete)
• Team oversight (view all teams/members)
• User impersonation for debugging
• System statistics overview
• Super admin middleware

Use case: Platform administration, user moderation, system monitoring

11. Collaboration

File: 16.collaboration.md | Status: Beta 🔬

Real-time collaboration with presence awareness:

• Live cursor tracking
• User presence indicators
• Real-time document sync
• Yjs + Durable Objects integration
• Conflict resolution

Use case: Collaborative editing, real-time dashboards, multiplayer features

12. Email

File: 17.email.md | Status: Stable ✅

Email infrastructure with Vue Email templates:

• Verification codes and magic links
• Password reset and team invitations
• Vue Email templates with Resend delivery
• Client flow components
• Integration with auth system

Use case: Authentication flows, transactional emails, team invitations

13. Pages (CMS)

File: 18.pages.md | Status: Stable ✅

CMS-like page management system:

• Block-based page editor
• Page types from app packages
• Tree organization with drag-and-drop
• Custom domain support
• Public page routing

Use case: Marketing sites, documentation, customer portals

14. Bookings

File: 19.bookings.md | Status: Experimental ⚠️

Booking system for appointments and reservations:

• Slot-based bookings (courts, rooms)
• Inventory-based reservations (equipment)
• Customer booking wizard
• Cart system for multiple bookings
• Email notifications (opt-in)

Use case: Sports facilities, healthcare, rentals, services

Note: API under active development.

15. Sales (POS)

File: 20.sales.md | Status: Experimental ⚠️

Event-based Point of Sale system:

• Products and categories
• Cart and checkout flow
• Helper authentication (PIN-based)
• Offline support
• Thermal receipt printing (opt-in)

Use case: Markets, pop-up shops, events, food service

Note: API under active development.

Choosing the Right Features

For Production Apps

Use Stable features with confidence. These are thoroughly tested and have stable APIs.

Recommended:

• Internationalization for multi-language needs
• AI Integration for chat and content generation
• Data Export for reporting and backups
• Admin Dashboard for user/team management
• Email for authentication and transactional emails
• Pages for CMS-like content management
• Any stable features you need

For Non-Critical Apps

Beta features are safe to use but may have minor API changes in future releases.

Consider:

• Rich Text Editor for content-heavy apps
• Maps Integration for location features
• Flow Visualization for workflows and decision trees
• Collaboration for real-time multiplayer features
• DevTools during development

For Experimentation

Experimental features are under active development. Use in development/staging, but be prepared for API changes.

Use with caution:

• Assets & File Management (storage patterns may evolve)
• Events System (hook signatures may change)
• Bookings (mini-app, API may change)
• Sales/POS (mini-app, API may change)

Feature Combinations

Many features work great together:

• i18n + Rich Text: Multilingual content with rich formatting
• AI + i18n: AI-powered content generation with translations
• Maps + Assets: Location-based image galleries
• Events + External Connectors: Sync data to external systems on changes
• Flow + Events: Trigger actions on workflow step changes
• AI + Flow: AI-assisted workflow creation and optimization
• DevTools + Any Feature: Debug and optimize during development

Migration Path

As features mature:

1. Experimental features get refined based on feedback
2. Beta features stabilize with consistent APIs
3. Stable features guarantee backward compatibility

We'll provide migration guides for any breaking changes in experimental/beta features.

Where to Go Next

After exploring features:

• API Reference → Detailed API docs for feature composables and components
• Guides → Best practices and troubleshooting
• Customization → Customize features to match your needs

Prerequisites

Before using advanced features:

• Completed Getting Started
• Understand Fundamentals
• Familiarity with Generation workflow

External Resources

Feature-specific external resources:

• i18n: Nuxt i18n Module
• Rich Text: Tiptap Editor
• AI: Vercel AI SDK, OpenAI API, Anthropic API
• Assets: Cloudflare R2, AWS S3
• Maps: Leaflet, Mapbox
• Flow: Vue Flow, Yjs, Cloudflare Durable Objects
• Events: Event-Driven Architecture

Feedback & Contributions

Help us improve features:

• Report bugs for any stability level
• Suggest API improvements for beta/experimental features
• Share use cases to help prioritize stabilization
• Contribute documentation improvements

Features graduate to stable status based on:

• Production usage and feedback
• API stability over time
• Comprehensive test coverage
• Complete documentation