Blockmage Project Template

A heavily customized and opinionated project template, utilizing devenv, custom Git hooks (via git-hooks.nix), and including formatters and linters for a multitude of different file types and programming languages (via treefmt and treefmt-nix).

Language Support

All language environments are disabled by default. They can be toggled in devenv.nix.

• Python
• JavaScript/TypeScript
• Go
• Rust
• Nix
• Solidity
• Shell

Formatting and Linting

File Type	Tools
Python	ruff, docformatter
JavaScript/TypeScript, CSS, JSON, GraphQL	biome
Golang	golangci-lint (gofumpt, golines, goimports)
YAML	yamlfmt
TOML	taplo
HTML	tidy (HTML Tidy)
Markdown	markdownlint-cli2, prettier
Shell Scripts	shfmt, shellharden
Nix	alejandra
Spellcheck	cspell
Secrets Detection	trufflehog

Git Hooks

• actionlint - Static checker for GitHub Actions workflow files
• check-added-large-files - Prevent large files from being committed (configured with 8MB limit)
• check-case-conflicts - Check for files with names that would conflict on case-insensitive filesystems
• check-merge-conflicts - Check for files that contain merge conflict markers
• check-symlinks - Check for broken symlinks
• editorconfig-checker - Verify that files are in harmony with .editorconfig
• end-of-file-fixer - Ensure files end with a single newline
• mixed-line-endings - Normalize line endings to LF
• treefmt - Format workspace files according to Treefmt configuration
• trim-trailing-whitespace - Remove trailing whitespace
• trufflehog - Detect and prevent committing secrets
• cspell-msg - Spellcheck commit messages
• cspell-wsp - Spellcheck committed files
• pyright - Static type checking for Python
• pytest - Run Python tests

Planned Features

• Project setup scripts for different stacks (Python/Python Polylith, Go, Node, Rust, etc.). Python projects will utilize templates in _meta/templates/.
• commitizen Git hook and configuration
• git-cliff for automated changelog generation
• Rust linters and formatters
• secretspec configuration