🚀 DevlinHub CLI

A modern CLI tool for scaffolding production-ready applications

From idea to project scaffold in minutes

✨ What is DevlinHub CLI?

DevlinHub CLI is a modern scaffolding tool that creates production-ready applications with zero configuration. It interactively guides you through creating a new project, setting up a repository, installing dependencies, and choosing a template.

🚀 Quick Start

# Install CLI globally
npm install -g devlinhub-cli

# Create a new project
devlinhub new my-awesome-app

🛠️ Interactive Prompts

When you run:

devlinhub new <project-name>

You will be prompted for:

1. Project Name – The folder name for your project.

   • Must include only letters, numbers, hyphens, or underscores.

2. Template Selection – Choose the type of project to scaffold (e.g., Next.js, Node.js, Expo, Hono, Fullstack).

   • You can also provide the template via --template <type> to skip the prompt.

3. Dependency Installation – DevlinHub will detect your package manager (npm, yarn, pnpm) and install dependencies automatically.

4. Git Initialization – Optionally initializes a new git repository and makes the first commit.

After setup, DevlinHub outputs the next steps, including:

cd my-awesome-app
pnpm run dev

📦 CLI Commands

Create Project

# Interactive mode
devlinhub new my-project

# Specify template directly
devlinhub new my-project --template nodejs

List Templates

# Show available templates
devlinhub list
# or
devlinhub ls

Help & Version

# General help
devlinhub --help

# Command-specific help
devlinhub new --help

# Check CLI version
devlinhub --version

🔧 Requirements

• Node.js >= 18

• Git (for cloning templates)

• Optional:

  • pnpm (recommended for monorepos)
  • npm / yarn (alternative package managers)

✅ Installation for Local Testing

Before publishing to npm, you can test locally:

# From CLI project root
npm link

# Test CLI commands
devlinhub --version
devlinhub new test-app
devlinhub list

To simulate a real npm install:

npm pack
npm install -g ./devlinhub-2.1.1.tgz
devlinhub new sample-app

🐛 Troubleshooting

CLI command not found

npm uninstall -g devlinhub-cli
npm install -g devlinhub-cli

Permission errors (macOS/Linux)

sudo npm install -g devlinhub-cli
# or
npx devlinhub new my-project

Dependency installation fails

# Clear npm cache
npm cache clean --force
# Or for pnpm
pnpm store prune

Git clone fails

• Check your internet connection
• Ensure Git is installed and in PATH

🤝 Contributing

• Fork the repository
• Add new templates or fix bugs
• Submit pull requests
• Report issues via GitHub

📄 License

MIT License - see LICENSE for details.

Built with ❤️ by Clement Kwasi

⭐ Star on GitHub 🐦 Follow on Twitter 💼 Connect on LinkedIn

Happy coding! 🚀