hyp new_en.md

hyp new — Create a New Project

Create a new HypGo project. Supports four project types.

Usage

hyp new <name>              # Full-stack web project (default)
hyp new web <name>          # Same (explicit)
hyp new cli <name>          # CLI tool project (Cobra)
hyp new desktop <name>      # Desktop application (Fyne GUI)
hyp new grpc <name>         # gRPC microservice

Web Project

hyp new myapp

Generated structure:

myapp/
├── app/
│   ├── controllers/home.go
│   ├── models/
│   └── services/
├── config/config.yaml
├── static/css/ js/ images/
├── templates/welcome.html
├── main.go
└── go.mod

CLI Project

v0.8.5+ CLI, Desktop, and gRPC project types are new in v0.8.5. v0.8.1 supports Web projects only.

hyp new cli mytool

Generated structure:

mytool/
├── app/
│   ├── commands/root.go
│   ├── models/
│   ├── services/
│   └── config/config.yaml
├── main.go
└── go.mod

Next: hyp generate command process

Desktop Project

v0.8.5+ Desktop (Fyne GUI) project is new in v0.8.5.

hyp new desktop myapp

Generated structure:

myapp/
├── app/
│   ├── views/main_view.go
│   ├── models/
│   ├── services/
│   └── config/config.yaml
├── main.go
└── go.mod

Next: hyp generate view settings

Note: Fyne requires a C compiler (gcc).

gRPC Project

v0.8.5+ gRPC project type is new in v0.8.5.

hyp new grpc userservice

Generated structure:

userservice/
├── app/
│   ├── proto/userservicepb/userservice.proto
│   ├── rpc/userservice_server.go
│   ├── models/
│   ├── services/
│   └── config/config.yaml
├── main.go
├── Makefile
└── go.mod

Next: hyp generate proto order

Requires: protoc + protoc-gen-go + protoc-gen-go-grpc

Essential Post-Creation Steps

cd myapp && go mod tidy
hyp ai-rules    # Essential: generate AI tool config files

Related Commands

• hyp api — API-only project
• hyp generate — Generate code
• hyp ai-rules — Generate AI config files