ATF Form 5320.23 Generator

A client-side web application for generating PDFs of ATF Form 5320.23 (National Firearms Act Responsible Person Questionnaire). All processing happens in your browser using WebAssembly - no data is sent to external servers.

Live Application

Access the form generator at: https://schlarpc.github.io/atf-5320.23-generator/

Features

• Complete client-side processing - Your data never leaves your browser
• Auto-save functionality - Form state preserved in the URL for bookmarking
• Signature capture - Draw your signature directly in the browser
• PDF generation - Creates properly formatted ATF Form 5320.23 PDFs
• Form validation - Real-time validation with inline error messages
• Smart field interactions - Auto-formatting for phone numbers, SSNs, and conditional field enabling

Building

With Nix (Recommended)

# Build the project
nix build

# Development environment with direnv
direnv allow  # enables automatic nix develop shell
npm run dev   # starts development server on port 8080

With Node.js/npm

# Install dependencies
npm install

# Development server
npm run dev

# Production build
npm run build

# Type checking
npm run type-check

Development

The project uses:

• TypeScript with strict configuration
• Vite for bundling with WebAssembly support
• mupdf.js for client-side PDF manipulation
• autopen for signature capture and serialization
• Nix for reproducible builds and deployment

Project Structure

• src/ - TypeScript modules (PDF generation, form logic, signature handling)
• index.html - Form UI
• static/ - PDF template and styles
• flake.nix - Nix build configuration

Privacy & Security

• All form processing happens locally in your browser
• No form data is transmitted to external servers
• Restrictive Content Security Policy implemented
• Open source under AGPL-3.0-or-later license

License

This project is licensed under the AGPL-3.0-or-later license. See the LICENSE file for details.