Getting Started
Introduction to @wayvo-ai/core
@wayvo-ai/core is a framework for building modern web applications with TypeScript, React 19, and Next.js 16. It provides a complete set of tools for data management, UI components, and application structure.
Core Philosophy
@wayvo-ai/core follows these principles:
- Type Safety First - Full TypeScript support with automatic type inference
- Developer Experience - Patterns and components that reduce boilerplate
- Performance - Optimized data fetching and reactive state management
- Flexibility - Use what you need, customize what you want
Architecture Overview
Data Layer
- DataSources - Define your database schema with attributes, joins, and access control
- Stores - Reactive state management that syncs with your DataSources
- Server Actions - Type-safe server-side operations for complex queries
UI Layer
- PageShell - Consistent page structure with error boundaries
- PageLayoutTemplate - Pre-built layouts for tables and forms
- Smart Search - Advanced filtering and search capabilities
- Form Components - Type-safe form inputs with validation
Application Structure
- Application Menu - Configurable sidebar navigation
- Routing - Next.js 16 App Router integration
- Authentication - Built-in session management
Key Concepts
DataSources
DataSources define your database tables with:
- Attribute definitions (types, validation, defaults)
- Join relationships
- Calculated fields
- Access control (roles and permissions)
- Lifecycle hooks (beforeInsert, afterUpdate, etc.)
Stores
Stores provide reactive state management:
- Automatic UI updates when data changes
- Dirty tracking for unsaved changes
- Server synchronization
- Query caching and deduplication
Components
Pre-built components handle common patterns:
- Tables with sorting, filtering, and pagination
- Forms with validation and error handling
- Dialogs that are resizable and movable
- Search with advanced filter operators
When to Use @wayvo-ai/core
@wayvo-ai/core is ideal for:
- Business Applications - CRUD-heavy applications with complex data relationships
- Admin Dashboards - Applications requiring tables, filters, and data management
- Internal Tools - Applications where developer productivity matters
- Rapid Prototyping - Quickly build and iterate on features
What's Next?
- Installation - Set up your project
- Quick Start - Build your first feature
- Comparisons - Coming from React Query, Prisma, or Redux?
- DataSources - Learn about data definitions