aclarknet Documentation

Documentation is organized as a flat set of topic-focused pages grouped below by area.

Getting Started:

• Getting Started with aclarknet

Deployment & Server Operations:

• Quick Deployment Guide
• Deployment Guide for aclarknet
• How to Add an SES IAM Role to Your EC2 Instance
• Automating Let’s Encrypt Certificate Renewal
• Managing Dependencies with Dependabot

Email:

• AWS SES Email Configuration Guide
• Fix Gmail Warning
• Email Authentication Explained
• Email DNS Records Reference
• Email Utilities Reference
• Gmail Warning Fix - Quick Summary

Clients & Testimonials:

• Client Categorization Feature
• Client Categorization Feature - Visual Overview
• Testimonials Quick Start Guide
• Notes as Testimonials Feature
• Notes Import Documentation

Invoicing:

• Invoice Dashboard Design
• Invoice Time Entry Formset Feature
• Copy Invoice Data for Emails
• Time Entry Relationships

Payments:

• Stripe Test Mode Configuration

Features:

• feedwell: Unified Social Feed

Testing:

• Manual Testing Guide for Client Categorization Feature

Reference:

• DB Views Module
• README
• Frontend Application
• Frontend Components
• Design System Reference

Getting Started

• New here? Start with Getting Started with aclarknet.

• Need a task guide? Use the sidebar sections such as Deployment & Server Operations or Email.

• Need implementation detail? See the Reference section.

Project Overview

aclarknet is a Django/Wagtail application with a React/Webpack frontend.

Tech Stack

Backend

• Django 6.0: Main web framework

• Wagtail: CMS framework for content management

• MongoDB: Database backend using django-mongodb-backend

• Django Allauth: Authentication and social account management

• Django reCAPTCHA: Google reCAPTCHA v3 integration for form protection

• Django SES: AWS Simple Email Service integration

• Python 3.13: Target Python version

Frontend

• React 19: UI library

• Webpack 5: Module bundler

• Tailwind CSS 4: Utility-first CSS framework

• Bootstrap 5: CSS framework

• Babel: JavaScript transpiler

• SASS: CSS preprocessor

Development Tools

• Ruff: Python linter and formatter

• ESLint: JavaScript linter

• Stylelint: CSS linter

• pytest: Testing framework

• pre-commit: Git hooks for code quality

• just: Command runner

Key Features

• Client Management: Categorize and feature clients on the public website

• Notes & Testimonials: Manage contact form submissions and client testimonials

• Contact Form: reCAPTCHA-protected contact form with email notifications

• Email Integration: AWS SES integration with IAM role support

• Wagtail CMS: Content management system

• feedwell: Unified social media feed (Mastodon, Bluesky) at /feedwell/

• Modern Frontend: React-based UI with Tailwind CSS

Quick Links

• Getting Started with aclarknet - Get started with aclarknet

• Quick Deployment Guide - Deploy to production

• Automating Let’s Encrypt Certificate Renewal - Automate SSL certificate renewal

• Testimonials Quick Start Guide - Manage testimonials

• AWS SES Email Configuration Guide - Configure email sending

• Fix Gmail Warning - Fix Gmail email warnings

• DB Views Module - Database model reference

• Client Categorization Feature - Understand client categorization

Important

Gmail showing warnings for your emails? See Gmail Warning Fix - Quick Summary for the short version, or Fix Gmail Warning for full instructions.

Indices and Tables

• Index

• Module Index

• Search Page