Byld is a software agency, offering premium senior software developers and designers for innovative software products.

Byld CLI

Build better. Build faster. Build with Byld.

Visit https://byld.dev to learn more about our software agency.

Installation

Install the Byld CLI globally using npm:

npm install -g @byldpartners/cli

Or using pnpm:

pnpm add -g @byldpartners/cli

Or using bun:

bun add -g @byldpartners/cli

Usage

Create a New Project

The main command is create (or c for short):

byld create my-project

Or without specifying a project name (you'll be prompted):

byld create

Project Setup Options

When you run byld create, you'll be presented with two options:

1. Use a Byld preset - Choose from our curated preset configurations
2. Custom stack - Build your own stack using better-t-stack's interactive prompts

Byld Presets

We offer several preset configurations optimized for different use cases:

Full-Stack React

• Stack: React + Hono + Drizzle + SQLite + Better Auth
• Best for: Full-stack React applications
• Description: Perfect for building modern React applications with a robust backend

Next.js Stack

• Stack: Next.js + Hono + Prisma + PostgreSQL + Clerk
• Best for: Enterprise-ready Next.js applications
• Description: Production-ready stack with enterprise-grade authentication

T3 Stack

• Stack: Next.js + tRPC + Prisma + NextAuth
• Best for: Type-safe full-stack applications
• Description: The popular T3 stack configuration with end-to-end type safety

Minimal Stack

• Stack: TanStack Router + Hono + SQLite
• Best for: Small projects and prototypes
• Description: Lightweight and fast, perfect for small projects

Custom Additions

After selecting your stack, you can optionally add:

• Custom GitHub Actions: Add your own workflow files to .github/workflows/
• Additional npm packages: Add extra dependencies to your project

The CLI will prompt you interactively for these additions.

Example Workflow

# Install the CLI
npm install -g @byldpartners/cli

# Create a new project
byld create my-awesome-app

# Follow the interactive prompts:
# 1. Choose "Use a Byld preset" or "Custom stack"
# 2. If preset, select from available presets
# 3. Optionally add custom GitHub Actions or packages
# 4. Wait for project creation to complete

# Navigate to your project
cd my-awesome-app

# Start development
npm run dev

Commands

byld create [project-name]

Create a new project with the specified name (or be prompted for it).

Aliases: byld c

Options: None (all configuration is done interactively)

byld help

Custom Additions Guide

Adding Custom GitHub Actions

When prompted, you can provide file paths to GitHub Actions workflow files. These will be copied to your project's .github/workflows/ directory.

Example:

Enter GitHub Action file paths (comma-separated): ./my-workflow.yml, ./another-workflow.yml

Adding Custom npm Packages

You can add additional npm packages during project creation. Specify packages with optional versions:

Examples:

Enter package names (comma-separated): lodash, [email protected], @types/node

The CLI will:

1. Add packages to package.json
2. Optionally install them immediately (if you choose to)

What's Under the Hood?

Byld CLI is a wrapper around create-better-t-stack, providing:

• Curated preset configurations
• Custom additions support
• Integration with better-t-stack

Contributing

We welcome contributions! Please feel free to submit issues or pull requests.

License

MIT

Support

For support, visit https://byld.dev or open an issue on GitHub.

Built with ❤️ by Byld