aclarknet Documentation

Welcome to the aclarknet documentation! This is a Django-based web application using Wagtail CMS with a modern frontend stack.

Documentation is organized as a flat set of topic-focused pages grouped below by area, rather than by learning stage.

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 Renovate

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

Payments:

• Stripe Test Mode Configuration

Testing:

• Manual Testing Guide for Client Categorization Feature

Reference:

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

Getting Started

New to aclarknet? Start with Getting Started with aclarknet to set up your development environment and create your first client.

Need to accomplish a specific task? Browse the section captions in the sidebar, such as Deployment & Server Operations or Email, for goal-oriented guides.

Looking for technical details? See the Reference section for database models and frontend architecture.

Project Overview

This is a Django-based web application using Wagtail CMS with a modern frontend stack. The project combines Django’s robust backend capabilities with Wagtail’s powerful content management features, along with a React-based frontend built with Webpack.

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: Powerful content management system

• 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 a quick fix, or Fix Gmail Warning for detailed instructions.

Indices and Tables

• Index

• Module Index

• Search Page