Scaffold modern web apps with best practices in seconds
npm install automater> Skip the setup, focus on the code - built for Hack Your Future
Automater is a CLI tool designed for Hack Your Future participants to instantly create production-ready web applications. Skip the boring configuration and jump straight into the design-to-code feedback loop that matters most in real development work.
While primarily built to support Hack Your Future assignments, Automater follows the Open-Closed Principle - stable core functionality that's easily extensible for other educational programs and use cases.
Automater solves the "blank page problem" for developers by providing:
- Instant scaffolding with automater create my-app --features=mui,biome
- Conflict-free integrations - installing MUI automatically handles Tailwind conflicts
- Best practice defaults - follows official docs from Vite, Next.js, MUI, Biome, etc.
- Incremental additions - add features to existing projects safely
Think npm create cloudflare@latest but for any stack combination with intelligent conflict resolution.
bash
NextJS + TypeScript + MUI + Toolpad + Biome + Cloudflare
npx automater create examples/opennext-mui-toolpad --features=mui-toolpad
`$3
$3
bash
automater list templates
automater list features
`
Supported Features
> 📖 Complete reference: See OPTIONS_OVERVIEW.md for detailed feature descriptions, sources, and compatibility matrix.
$3
- serverHardening (Default): Production-ready security headers following OWASP guidelines
- biome (Default): Fast Rust-based linter/formatter from Biome project🔒 Security Best Practices - Detailed security implementation and verification guide.
$3
- mui: Material-UI components with official Next.js integration
- mui-toolpad: Complete admin dashboard with MUI Toolpad Core - includes theme system, DataGrids, and CRUD pages$3
- cloudflare: Cloudflare Pages with Workers integration$3
All templates include serverHardening and biome by default for production readiness and optimal developer experience.Coding Principles
Automater follows essential development principles that help developers write clear, maintainable code:
- RTFM (Respect The Framework's Model): Follow official documentation and framework conventions
- C4C (Coding For Clarity): Write code that's easy to read and understand
- C4I (Code for Inclusivity): Make your code accessible to new team members
- KISS (Keep It Simple Stupid): Choose simplicity over cleverness
- YAGNI (You Aren't Gonna Need It): Don't build features until they're needed
- HIPI (Hide Implementation, Present Interface): Encapsulate complexity behind clear APIs
- NBI (Naming by Intention): Use names that clearly express purpose and behavior
Every generated project embeds these principles through code comments, structure, and tool choices.
📖 More Information - Detailed explanations, enterprise principles, SOLID, and 15-factor app guidelines.
🔧 Toolpad Best Practices - Essential patterns for MUI Toolpad implementation based on official examples.
How It Works
$3
Automater intelligently handles conflicts between tools:- Installing MUI removes Tailwind and offers CSS-in-JS alternatives
- Adding Biome replaces existing ESLint + Prettier configurations
- Framework-specific integrations follow official documentation
$3
Every feature follows official documentation:
- MUI installation uses the exact steps from MUI Next.js guide
- Biome setup follows Biome getting started
- Vite configuration matches Vite official templatesDevelopment
$3
- Node.js 18+
- pnpm (recommended) or npmContributing
We welcome contributions! Here's how to get started:
$3
1. Create feature config in
2. Add template files in
3. Update conflict resolution rules if needed
4. Add tests and documentation$3
1. Create template directory in
2. Add template config in
3. Test with various feature combinations
4. Update documentation$3
- Follow existing code style (Biome formatting)
- Add tests for new features
- Update documentation
- Follow official documentation for integrations
- Test conflict resolution scenarios$3
1. Fork the repository
2. Create a feature branch:
3. Make your changes and add tests
4. Run and pnpm build`See CONTRIBUTION.md
This project is free and open source, but it wasn't free to build. If Automater saves you time and helps your development workflow, please consider supporting its continued development.
Your support helps:
- Maintain and improve existing features
- Add new templates and integrations
- Provide community support
- Keep the project sustainable
Every contribution, no matter the size, makes a difference and is greatly appreciated! 🙏
MIT License - see LICENSE for details.
- 📖 Documentation
- 🐛 Issues
- 💬 Discussions