🚀 Structify

✨ What is Structify?

Structify is a professional, open-source developer productivity platform and command-line interface (CLI) designed to eliminate repetitive project setup.

Instead of manually creating folders, installing packages, configuring TypeScript, ESLint, Prettier, Docker, testing frameworks, databases, ORMs, CI/CD pipelines, and project architecture, Structify generates a complete, production-ready project structure using a single command.

Structify focuses on creating consistent, maintainable, and enterprise-grade project foundations while remaining deterministic, transparent, and safe.

🎯 The Problem

Every time developers start a new project, they spend hours performing repetitive setup work:

• Creating folder structures manually.
• Installing npm dependencies.
• Configuring TypeScript.
• Setting up ESLint and Prettier.
• Creating Docker files.
• Configuring databases and ORMs.
• Setting up GitHub Actions.
• Creating testing infrastructure.
• Writing boilerplate configuration files.
• Organizing project architecture.

Most existing scaffolding tools only support a single framework or generate minimal templates that still require significant manual configuration before development can begin.

💡 The Solution

Structify automates project initialization while remaining:

• Transparent — Shows a deterministic execution plan before making changes.
• Predictable — Supports dry-run execution with reproducible output.
• Safe — Uses transactional file operations with automatic rollback.
• Framework Agnostic — Supports multiple project architectures through a unified generation engine.
• Extensible — Built using modular generators, templates, blueprints, and plugins.
• AI Ready — Includes a built-in Model Context Protocol (MCP) server for AI-powered tooling.

✨ Features

Project Generation

• Production-ready project scaffolding
• Configuration-driven generation
• Preset-based generation
• Deterministic execution planning
• Dry-run support
• Rollback-safe generation
• Intelligent project validation

Project Health

• Project verification
• Doctor diagnostics
• Repair recommendations
• Project inspection
• Drift detection
• Upgrade planning

Enterprise Platform

• Enterprise template engine
• Blueprint system
• Variable resolution engine
• Workspace generation
• Component generation
• Registry architecture
• Planning engine
• Merge engine
• Diagnostics framework

Developer Experience

• npm-first architecture
• TypeScript-first
• JSON output support
• CI-friendly commands
• Cross-platform support
• Machine-readable diagnostics

AI Integration

• Built-in MCP server
• AI-compatible project inspection
• AI-compatible generation planning
• AI-compatible diagnostics

📦 Project Structure

Structify
│
├── apps
│   ├── cli
│   └── mcp-server
│
├── packages
│   ├── core
│   └── logger
│
├── docs
│
└── scripts

🚀 Installation

npm install -g structify

or

npx structify

🚀 Quick Start

Create a new project:

structify init my-project

or

structify generate my-project

Verify an existing project:

structify verify-project

Check project health:

structify doctor

Inspect a project:

structify inspect

Repair issues:

structify repair --dry-run

🏗️ Design Principles

Minimal Effort, Premium Output

Generate production-grade workspaces within seconds.

Deterministic & Safe

Every operation is predictable, transactional, and rollback-safe.

Opinionated but Extensible

Provides excellent defaults while remaining highly extensible.

Modular Architecture

Every engine is isolated, making it easy to extend Structify without modifying the core.

AI Ready

Native support for Model Context Protocol (MCP) enables AI assistants to understand and interact with Structify projects.

📚 Documentation

Comprehensive documentation is available in the docs/ directory, including:

• Architecture Guide
• CLI Guide
• CLI Commands
• Manifest Specification
• Project Graph
• Virtual File Graph
• Package Manager Adapters
• Verification Reports
• Roadmap

📌 v1.0 Scope

Structify v1.0 focuses on providing a stable, production-ready foundation for project scaffolding and developer tooling.

Included in v1.0

• ✅ Project generation
• ✅ Configuration-driven generation
• ✅ Presets
• ✅ Project verification
• ✅ Doctor
• ✅ Inspect
• ✅ Repair
• ✅ Upgrade planning
• ✅ Enterprise template platform
• ✅ Blueprint architecture
• ✅ Rollback engine
• ✅ Planning engine
• ✅ Registry architecture
• ✅ MCP server
• ✅ JSON output
• ✅ npm-first workflow
• ✅ Cross-platform support

🚀 Coming in v1.1

The next major release will focus on improving the developer onboarding experience.

Planned Features

• 🎯 Interactive Project Architect Wizard
• 🎯 Framework selection (React, Next.js, Express, NestJS, etc.)
• 🎯 Styling selection (Tailwind CSS, Material UI, Chakra UI, Bootstrap, etc.)
• 🎯 Database selection (PostgreSQL, MongoDB, MySQL, SQLite, MSSQL)
• 🎯 ORM selection (Prisma, Drizzle, TypeORM, Mongoose)
• 🎯 Authentication presets
• 🎯 Docker & CI setup wizard
• 🎯 Rich terminal UI
• 🎯 Improved onboarding experience

🤝 Contributing

Contributions, ideas, feature requests, and bug reports are always welcome.

Please read the project's contribution guidelines before submitting pull requests.

📄 License

This project is released under the MIT License.