README

Web application development kit

Darkwave is a "batteries-included" tool kit for building data-driven web applications with Astro.

We've curated a selection of reliable and approachable tools to create a professional-grade full-stack boilerplate with pre-wired functionality and components for common SaaS and CRUD features.

DW facilitates a hyper-productive development workflow, helping developers focus on delivering real value with ease.

Read the full documentation and user guide at darkwavejs.com

What's Included?

Core Stack

• Astro (SSR w/ Node.js adapter and TypeScript)
• Tailwind CSS with typography and forms plugins available
• shadcn/ui UI components
• Better-Auth for authentication
• MySQL (8.0) with Kysely query builder & cli

Additional Utilities

• Alpine.js - JavaScript framework for enhanced interactivity
• HTMX - Modern approach to dynamic content without writing JavaScript
• Cropper.js - Image cropping library
• Dropzone - Drag & drop file upload interface
• SortableJS - Drag & drop sorting library
• Validator.js - String validation
• Iconify - Icon framework with Tabler icons set

Application Boilerplate

• Global middleware
• Configuration management
• DB schema & migrations
• RBAC authentication rules
• Authentication flows (register, login, fogot pw)
• Extendable admin app with user management

Utilities

• UI & form components
• Full-stack photo upload solution!
• CRUD abstractions, CSRF validation
• Storage adapters for uploaded media
• Programmatic email
• Misc helper functions
• CLI utilities

Getting Started

Clone the repository

npx degit jyoungblood/darkwave my-project
cd my-project

Install dependencies

npm install

Initialize your database and SMTP account, have the credentials ready to add to your new .env file.

Configure environment variables (add your database, mail server, etc)

mv .env.example .env

Generate Better-Auth secret (save this to your .env file)

openssl rand -base64 32

Initialize the database (and optionally create admin user)

npm run init

Start development server

npm run dev

Refer to the documentation for next steps.

License

This project is licensed under the MIT License - see the LICENSE file for details.

* . · : · . ☽ ✧

• DW Classic - legacy PHP-based version