Start a project

A project is the unit of work in Subaya: it holds your design, requirements, simulations, and (optionally) a connected Git repo. Projects live inside a workspace, which lives inside your organization. See Core concepts for how these fit together.

Create a project

Every project is typed — either an FPGA project or an embedded project — because the toolchains and phases differ:

suya project create \
  --name "Blinky" \
  --workspace <workspace-id> \
  --type embedded

Flag	Meaning
--name	Human-readable project name (required)
--workspace	Workspace id the project belongs to (required)
--type	fpga or embedded (required)
--slug	URL-safe slug (defaults to a slug derived from the name)
--device	A device id from the catalog to target (optional)

Find your workspace id in the console, or list projects you already have:

suya project list --workspace <workspace-id>

The local project config

When you work inside a project directory, Subaya keeps a small .subaya/config.toml that records the project id. Most commands then default --project from it, so you can drop the flag:

suya project show          # shows the project from .subaya/config.toml
suya project phase         # get or set the current phase

Pick a target device (optional)

If you know the chip or board you’re targeting, attach it from the curated catalog:

suya device search --type embedded
suya device show <device-id>
suya device set <device-id>

Next steps

• Connect a GitHub repo so your design lives in Git.
• Plan your project to break the idea into work items.
• For embedded boards, jump to the STM32 getting started worked example.