Quickstart Guide
Guide users through account setup and first steps to create and manage their initial documentation space.
Overview
Get started with Dan Mackenzie in minutes. This guide walks you through creating an account, setting up your workspace, adding your first document, and publishing it live. Follow these steps to organize your project documentation effectively.
Prerequisites
Before beginning, ensure you have:
- A modern web browser (Chrome, Firefox, Safari, or Edge)
- An email address for account verification
- Stable internet connection
No software installation required—everything runs in your browser.
Step-by-Step Setup
Follow these sequential steps to launch your first documentation space.
Create Account
Visit https://app.danmackenzie.co.uk/signup and enter your email and password.
Verify your email by clicking the link sent to your inbox. This enables full access to workspaces.
Use a strong password. Enable two-factor authentication in account settings later.
Set Up Workspace
After login, click New Workspace from the dashboard.
Name it (e.g., "Project Docs") and select a template like "Starter Kit".
Customize the brand color to #007bff and add your slogan: "A quieter, more thoughtful way to create and work online."
Save to create your space.
Add First Document
In your workspace, select New Document > MDX Page.
Use the editor to add content. Here's a basic example:
## Welcome
This is your first document in Dan Mackenzie.
<Callout kind="success">
Ready to publish!
</Callout>
---
title: Welcome
description: Your first page.
---
## Content starts here.
Preview and Publish
Click Preview to see a live render.
Review navigation and components. Satisfied? Hit Publish.
Share the live URL: https://docs.danmackenzie.co.uk/your-workspace/welcome.
Platform-Specific Installation
If using the optional desktop app for offline editing:
Download from the dashboard.
# Mount DMG and drag to Applications
open DanMackenzie.dmg
Launch and connect your workspace.
# Run the installer
DanMackenzie-Setup.exe
Extract and run:
tar -xzf dan-mackenzie.tar.gz
./DanMackenzie.AppImage
Next Steps
Explore more features to enhance your documentation.
Customize Navigation
Add pages, set menus, and theme your site.
Advanced Components
Use Boards, Steps, and API docs for richer content.
Collaboration
Invite team members and manage permissions.
Export & Backup
Learn to export sites or sync with GitHub.
Congratulations! Your documentation space is live. Customize further or explore the full docs.