Contact Form

LinkDen includes an optional contact form that lets visitors send you messages without exposing your email address. Messages are delivered to your inbox via Resend and stored in the database for viewing in the admin panel.

How It Works

1. A visitor fills out the contact form on your public page (name, email, message).
2. Cloudflare Turnstile verifies the submission is from a real person (if configured).
3. The message is saved to your D1 database.
4. If Resend is configured, an email notification is sent to your address.
5. You can view and manage all submissions in the admin panel at /admin/contacts.

Setting Up the Contact Form

Enable the Form

The contact form is enabled by default. You can toggle it on or off in /admin/settings under the Contact section.

Configure Resend (Recommended)

To receive email notifications when someone submits the form:

1. Create an account at resend.com.
2. Add and verify your domain, or use the sandbox domain for testing.
3. Generate an API key from the Resend dashboard.
4. Add to apps/server/.env:

RESEND_API_KEY=re_your_api_key_here
RESEND_FROM_EMAIL=contact@yourdomain.com

Without Resend, messages are still saved to the database but no email is sent.

Configure CAPTCHA (Recommended)

LinkDen supports three CAPTCHA modes. Select the type in Admin > Settings > Contact Form > CAPTCHA Type:

Simple Math CAPTCHA (No external account required)

The simplest option. The form displays a randomly generated arithmetic question (e.g., "What is 4 + 7?"). The answer is validated server-side. No API keys, no third-party services, no cookies. Ideal for low-traffic sites or when you want zero external dependencies.

To enable: set CAPTCHA Type to Simple Math in the admin settings. No environment variables are required.

Cloudflare Turnstile (Recommended for Cloudflare deployments)

Privacy-friendly, invisible challenge from Cloudflare. Ideal if you are already on the Cloudflare stack.

1. Go to the Turnstile section in the Cloudflare dashboard.
2. Add your site and select the managed challenge type.
3. Add to your environment files:

# apps/web/.env
NEXT_PUBLIC_TURNSTILE_SITE_KEY=0x4AAAAAAA...

# apps/server/.env
TURNSTILE_SECRET_KEY=0x4AAAAAAA...

Then set CAPTCHA Type to Cloudflare Turnstile in admin settings.

Google reCAPTCHA v2

Traditional checkbox CAPTCHA from Google.

1. Register your site at google.com/recaptcha.
2. Add to your environment files:

# apps/web/.env
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=6Le...

# apps/server/.env
RECAPTCHA_SECRET_KEY=6Le...

Then set CAPTCHA Type to Google reCAPTCHA in admin settings.

Without any CAPTCHA configured, the form works but has no bot protection.

Managing Submissions

Navigate to /admin/contacts to view all form submissions:

• Inbox -- New, unread submissions.
• Read -- Submissions you have viewed.
• Archive -- Submissions you have archived.

Each submission shows:

• Sender name and email.
• Message content.
• Submission date and time.
• Read/unread status.

You can reply directly by clicking the sender's email address, which opens your email client with the address pre-filled.

Form Fields

The contact form includes:

The form validates all fields client-side before submission and shows inline error messages.