Starter Kits
Dracory provides an official starter kit to help you get started with your application quickly. It ships with pre-configured tooling for common application needs, allowing you to focus on building your application's unique features rather than setting up boilerplate code.
Available Starter Kits
Dracory Blueprint
The official Dracory starter application. A full-featured web app scaffold wiring together the Dracory packages, ready for rapid application development.
- User authentication (OTP, magic link, password)
- Configurable data stores and migrations
- Admin panels via blogadmin, shopadmin, and friends
- CLI commands, tasks, and scheduled jobs
- Docker support and deployment utilities
Using the Starter Kit
To start a new project from the Blueprint, follow these steps:
-
Clone the Blueprint repository:
git clone https://github.com/dracory/blueprint.git myapp -
Navigate to the project directory:
cd myapp -
Remove the upstream Git history (optional but recommended):
rm -rf .git && git init -
Install dependencies:
go mod tidy -
Configure your environment:
cp .env.example .env # Edit .env with your configuration -
Run the application:
task dev
See the Installation guide for a fuller walkthrough,
including the manual download option and task dev-init bootstrap.
Customizing the Starter Kit
The Blueprint is designed to be a starting point for your application. You can customize it to fit your specific needs by:
- Adding new controllers, models, and views
- Modifying the existing routes and middleware
- Enabling or disabling data stores via
internal/config/stores_config.go - Customizing the UI and styling
- Integrating additional packages and services
The Blueprint follows Dracory's best practices and coding conventions, making it easy to extend and maintain your application as it grows.