Home

Welcome to the Dracory documentation. Explore guides, concepts, and best practices to get the most out of Dracory.

Welcome to Dracory Documentation

Dracory is a modern web application framework designed to make development fast, efficient, and enjoyable. This documentation will guide you through all aspects of using Dracory to build your applications.

Current Version: v0.37.0

Core Features

Architecture

  • App Pattern: Central dependency registry for type-safe service management
  • Router: Built on github.com/dracory/rtr with flexible middleware support
  • Configuration: Environment-based configuration with interface-based design
  • Background Processing: Task queues and scheduled jobs with context-aware shutdown

Data Stores (25+ Available)

  • Core Stores: User, Session, Audit, Log, Meta, Setting, Task, Cache
  • Content Stores: Blog, CMS, Custom, Entity, Feed, Stats
  • Security Stores: Vault, Blind Index (email, first name, last name)
  • Advanced Stores: Chat, Chat RAG, Geo, Shop, Subscription, SQL File
  • Specialized: Stats, Version, Feed, Entity

Frontend

  • HTML Builder: github.com/dracory/hb for type-safe HTML generation
  • Theme System: Blog and web theme packages for consistent styling
  • Components: Widget system with registry access
  • Responsive: Mobile-first design with modern CSS

Integrations

  • AI/LLM: Support for Anthropic, Google Gemini, OpenRouter, OpenAI, Vertex AI
  • Databases: PostgreSQL, MySQL, SQLite, Turso with automatic optimizations
  • Cloud: Google Cloud Platform integration
  • Authentication: Built-in auth with rate limiting, API key validation, and CSRF protection
  • Email: Standalone email package with multiple drivers

Development Tools

  • CLI: Generic type-safe command dispatcher
  • Hot Reload: Air integration for development
  • Testing: Comprehensive test utilities with automatic store migrations
  • Migrations: Database migration system with per-store migration files
  • Deployment: Docker support and deployment utilities
  • Task Constants: Compile-time safe task alias constants via internal/tasks/constants

Getting Started

If you're new to Dracory, we recommend starting with the installation guide and then exploring the directory structure to understand how Dracory applications are organized.

Core Concepts

Explore the core concepts that make Dracory powerful and flexible.

Installation

Learn how to install and set up your Dracory application.

Read More

Directory Structure

Understand how Dracory applications are organized with the new registry pattern and cmd/server entry point.

Read More

Configuration

Learn how to configure your Dracory application, including environment variables, encrypted configuration, and SSL settings.

Read More

Frontend

Build beautiful user interfaces with Dracory's HTML builder, theme system, and responsive design.

Read More

Packages

Explore the extensive ecosystem of Dracory packages for stores, utilities, and integrations, including the new standalone email package.

Read More

Security

Learn about security best practices, including environment variable encryption, bot protection, HTTPS redirects, and rate limiting.

Read More

Deployment

Understand deployment strategies, Docker configuration, and production considerations.

Read More