Skip to main content

Build commands

info

You can use yarn cli as a drop in replacement for apic.

The Build commands are used to build API specs, clients, playground, snippets and guides.

Usage for specs

client defaults to all

The client parameter is variadic, you can pass multiple client name

apic build specs <client... | all>

Available options

OptionCommandDescription
verbose-v, –verboseMake the process verbose, display logs from third party tools
skip cache-s, –skip-cacheSkip cache checking to force building specs
docs-d, –docsBuilds the specs for the Algolia doc, which embeds the snippets

Build specs

Build all specs

apic build specs

Build specific spec

apic build specs recommend

Build many spec

apic build specs recommend search ingestion

Lint

Fix specs

Automatically done when building specs

yarn specs:fix

Check specs

If you just want to check the format (not override the files)

yarn specs:lint search

Usage for clients, playground, snippets and guides

language and client defaults to all

The client parameter is variadic, you can pass multiple client name

scope is one of: clients | playground | snippets | guides

apic build <scope> <language | all> <client... | all>

Available options

OptionCommandDescription
verbose-v, –verboseMake the process verbose, display logs from third party tools

Build

Build all clients for all supported languages

apic build clients

Build playground for specific language

apic build playground javascript recommend

Build many snippets for specific language

apic build snippets java insights recommend search