AuraDash

Welcome to the comprehensive AuraDash guide. Everything you need to set up, deploy to Cloudflare, configure databases, connect your client website, and run locally in simple, plain language.

How AuraDash Works (Simplified Architecture)

AuraDash consists of 6 core components that run together on Cloudflare's global edge network at zero infrastructure cost:

Frontend (Admin Dashboard)

The web interface where you log in, write articles, view bookings, and manage your team. Deployed on Cloudflare Pages.

Backend (Server & REST API)

The ultra-fast engine powered by Hono on Cloudflare Workers. Handles logins, validation, and responds to public website requests.

Database (Cloudflare D1 SQL)

Cloudflare D1 serverless SQLite database. Stores all your articles, services, user accounts, and customer booking submissions.

Media Storage (Cloudflare R2)

Cloudflare R2 stores all your uploaded images and media. Zero egress fees, ultra-fast global CDN delivery.

Email Routing (System Emails)

Cloudflare Email Routing sends password reset codes and booking notifications directly from your official custom domain.

Custom Domain & SSL

Connect your own custom domain (e.g. dashboard.yourdomain.com) with free automatic SSL encryption.

How to Connect & Deploy Your Client Website on Cloudflare (3 Simple Steps)

When you deploy your customer-facing landing page or website to Cloudflare Pages, you only need to copy 2 values from your AuraDash dashboard:

Get Your 2 Keys

From your live AuraDash setup, you need:

1. Public API URLhttps://api.yourdomain.com/api/public

2. Production API KeyGo to Settings ➔ API Keys, click Create Production Key, enter your domain, and copy the key.

Paste into Cloudflare Pages

In your Cloudflare Pages dashboard, go to Settings ➔ Environment Variables and add these 2 values:

Name:AURADASH_API_URL

Value:https://api.yourdomain.com/api/public

Name:AURADASH_API_KEY

Value:auradash_pk.xxxx...

Click Deploy!

Click Deploy. That's all! Your Cloudflare Pages site is live and connected:

Articles & services sync in real-time.

Customer bookings land in your admin inbox.

Free automatic SSL certificate included.

Cloudflare Pages Deployment Configuration:

1. Production Variables

In Cloudflare Pages ➔ Settings ➔ Environment variables ➔ Add AURADASH_API_URL and AURADASH_API_KEY under Production.

2. Preview Branches

Also add the variables under Preview so every pull request and feature branch automatically connects to your live AuraDash API.

3. Global Edge & SSL

Click Save and Deploy. Cloudflare instantly compiles and distributes your site across 300+ edge data centers with free automatic SSL.

Building your customer website using AI tools (Cursor, Bolt.new, Lovable, Antigravity)?

Copy AI Master Prompts

Complete Step-by-Step Deployment Guide (From Zero to Production)

Follow these 5 straightforward phases to set up your Cloudflare services, deploy your code, and connect your custom domain:

Phase 1

Prepare Free Cloudflare Resources (Database, Storage & Email)

1. Create D1 Database

Go to Storage & Databases ➔ D1 SQL Database ➔ Create Database.

Database Name:auradash

2. Create R2 Bucket

Go to R2 Object Storage ➔ Create Bucket.

Bucket Name:auradash-storage

💡 In Bucket Settings, enable R2.dev subdomain or connect a Custom Domain (e.g. cdn.yourdomain.com) to get your public image URL.

3. Create KV Namespace

Go to Storage & Databases ➔ KV ➔ Create Namespace.

Namespace Name:K1

4. Enable Email Routing

Go to your domain ➔ Email Routing ➔ Enable.

Sender Address:noreply@yourdomain.com

Phase 2

Generate Master Cryptographic Key (`AURADASH_MASTER_SECRET`)

Generate your high-entropy secret key below. You will use this key in your Cloudflare environment variables:

Cryptographic Master Secret Generator512-bit Entropy

Generated securely inside your browser using Web Crypto API. Never sent over the internet.

Key Length / Security Strength:

Character Format:

Generated Secret (Value for AURADASH_MASTER_SECRET):

Security Guarantee: This key contains 0 characters of high-entropy randomness. It provides unbreakable mathematical protection for your public API signatures.

Phase 3

Environment Variables & Secrets Reference

Here is the complete reference of all environment variables for both Backend and Frontend, with clear explanations of what each does:

1. Backend Environment Variables (Cloudflare Worker):

Variable Name	Type	Example Value	Purpose & Explanation
AURADASH_MASTER_SECRET	Secret (Encrypted)	Generated 64-char key	The master key used to mathematically sign and verify all API keys at the edge.
R2_PUBLIC_URL	Plain Variable	https://pub-xxxx.r2.dev	The public URL of your R2 Bucket where uploaded article and service images are accessed.
ALLOWED_ORIGINS	Plain Variable	https://dashboard.yourdomain.com	Allowed frontend dashboard domain for CORS security checks.
APP_FRONTEND_URL	Plain Variable	https://dashboard.yourdomain.com	The web address of your dashboard, used inside password reset email links.
EMAIL_FROM_ADDRESS	Plain Variable	noreply@yourdomain.com	The official sender email address used for system emails.

2. Frontend Environment Variables (Cloudflare Pages):

Variable Name	Type	Example Value	Purpose & Explanation
NEXT_PUBLIC_API_URL	Plain Variable	https://api.yourdomain.com/api	The full public URL of your deployed backend worker so the dashboard can fetch data.

Phase 4

Deploy Backend & Frontend Applications

1. Deploy Backend (Cloudflare Workers)

Deploy the Hono API server and apply database tables to Cloudflare D1:

Run npm run db:remote to initialize tables.

Run npm run deploy to push worker code.

1-Click Deploy Backend

2. Deploy Frontend (Cloudflare Pages)

Connect your repository to Cloudflare Pages:

Root directory: frontend

Build command: npm run build:cloudflare

Output directory: .open-next

Deploy on Cloudflare Pages

Phase 5

Connect Custom Domain & Automatic SSL

Link your brand's custom domain name to your dashboard and API in seconds:

1. Domain for Frontend Dashboard

In Cloudflare Pages ➔ Select your project ➔ Custom domains ➔ Click Set up a domain.

dashboard.yourdomain.com

Cloudflare will automatically configure DNS records and issue a free SSL certificate.

2. Domain for Backend API

In Workers & Pages ➔ Select auradash-backend ➔ Settings ➔ Domains & Routes ➔ Custom Domains.

api.yourdomain.com

Provides a clean, professional API endpoint for your public client web and mobile apps.

Full Video Walkthrough & Deployment Guide

Watch our step-by-step video tutorial covering local setup, database initialization, and deploying to Cloudflare in under 5 minutes.

Full Walkthrough Guide10:45 min

YouTube Guide

Deploy & Run AuraDash for the First Time

Follow along with this step-by-step visual tutorial to get your workspace live:

00:00 — Project Architecture & OverviewIntro

01:30 — Local Database Setup (`npm run db:init`)Local

04:15 — Deploying Cloudflare Workers & D1Cloud

07:40 — Deploying Next.js to Cloudflare PagesFrontend

09:20 — Setting Master Secret & First Admin LoginSecurity

Watch Full Video on YouTube Channel

Official Local Development Guide (Step-by-Step)

Follow this official standard procedure to clone, initialize, and run AuraDash locally on your machine with full D1 database simulation.

System Prerequisites

Node.jsVersion 18.0.0 or higher (LTS recommended)

Package Managernpm (v9+), pnpm (v8+), or bun

GitInstalled and configured on your OS

Clone the Repository

Clone the official AuraDash monorepo from GitHub to your computer:

bash

git clone https://github.com/Ymzerotwo/auradash.git
cd auradash

Install Dependencies (Backend & Frontend)

Install all required packages for both the Hono Workers backend and Next.js frontend:

bash

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

Initialize Local Cloudflare D1 Database (`npm run db:init`)

Execute the database initializer script to apply all 10 SQL schema tables to your local Miniflare D1 database:

bash

cd ../backend
npm run db:init

💡 What this does: Creates all database tables (`auth`, `services`, `articles`, `bookings`, `customers`, `inbox`, `notifications`, `comments`, `apikeys`, `settings`) and seeds the default administrator account.

Configure Environment Variables

Configure your local environment files for backend and frontend:

Backend: `backend/.dev.vars`

env

AURADASH_MASTER_SECRET="your_custom_master_crypto_secret_32_chars_min"
ALLOWED_ORIGINS="http://localhost:3000,http://localhost:3001"
R2_PUBLIC_URL="https://pub-your-bucket.r2.dev"

Frontend: `frontend/.env.local`

env

NEXT_PUBLIC_API_URL="http://localhost:8787/api"

Start Development Servers (VS Code or CLI)

You can start both frontend and backend concurrently using the pre-configured VS Code task or standard CLI:

Option A: 1-Click VS Code Execution (Recommended).vscode/tasks.json

Press the default build shortcut inside VS Code to launch both servers simultaneously in dedicated terminal panels:

Windows / Linux:Ctrl+Shift+B

macOS:Cmd+Shift+B

💡 Alternatively, open Terminal ➔ Run Build Task from the top VS Code menu bar.

Option B: Manual Terminal Execution (CLI)

Terminal 1 — Backend (Port 8787)

bash

cd backend
npm run dev

Terminal 2 — Frontend (Port 3000)

bash

cd frontend
npm run dev

Initial Login Credentials & Security Warning

Open http://localhost:3000 in your browser and sign in using the seeded administrator credentials:

Usernameadmin

Emailadmin@auradash.local

Default PasswordAuraDash@2026

Mandatory Action: Change this password immediately from Profile Settings after logging in for the first time.

How AuraDash Works (Simplified Architecture)

AuraDash consists of 6 core components that run together on Cloudflare's global edge network at zero infrastructure cost:

Frontend (Admin Dashboard)

The web interface where you log in, write articles, view bookings, and manage your team. Deployed on Cloudflare Pages.

Backend (Server & REST API)

The ultra-fast engine powered by Hono on Cloudflare Workers. Handles logins, validation, and responds to public website requests.

Database (Cloudflare D1 SQL)

Cloudflare D1 serverless SQLite database. Stores all your articles, services, user accounts, and customer booking submissions.

Media Storage (Cloudflare R2)

Cloudflare R2 stores all your uploaded images and media. Zero egress fees, ultra-fast global CDN delivery.

Email Routing (System Emails)

Cloudflare Email Routing sends password reset codes and booking notifications directly from your official custom domain.

Custom Domain & SSL

Connect your own custom domain (e.g. dashboard.yourdomain.com) with free automatic SSL encryption.

Variable Name

Type

Example Value

Purpose & Explanation

AURADASH_MASTER_SECRET

Secret (Encrypted)

Generated 64-char key

The master key used to mathematically sign and verify all API keys at the edge.

R2_PUBLIC_URL

Plain Variable

https://pub-xxxx.r2.dev

The public URL of your R2 Bucket where uploaded article and service images are accessed.

ALLOWED_ORIGINS

Plain Variable

https://dashboard.yourdomain.com

Allowed frontend dashboard domain for CORS security checks.

APP_FRONTEND_URL

Plain Variable

https://dashboard.yourdomain.com

The web address of your dashboard, used inside password reset email links.

EMAIL_FROM_ADDRESS

Plain Variable

noreply@yourdomain.com

The official sender email address used for system emails.

Variable Name

Type

Example Value

Purpose & Explanation

NEXT_PUBLIC_API_URL

Plain Variable

https://api.yourdomain.com/api

The full public URL of your deployed backend worker so the dashboard can fetch data.