LakeQL
Introduction
  • Overview
  • Why LakeQL
  • Key Concepts
Getting Started
  • Prerequisites
  • Quickstart
  • Environment
  • First Run
Architecture
  • System Overview
  • Data Flow
  • Request Lifecycle
Configuration
  • Config File
  • Runtime Lifecycle
  • Environment Variables
create-app
  • Usage
  • Template Structure
  • Post-Creation
Guides
  • Custom Resolvers
  • Extending the Schema
  • Mutations
  • Set Up a Trino Mutation
  • Deploying
Endpoints
  • Definition Format
  • Field Types
  • Nested Fields
  • Mutations
  • Glossary
Contributing
  • Local Development
  • Contribution Guide
  • Architecture
GitHub
LakeQL
  1. LakeQL
  2. create-app
  3. Usage

On this page

  1. Options
    1. --adapters <ids>
    2. --ds-names <names>
    3. --auth <strategy>
    4. -d, --target-dir <path>
    5. -p, --package-manager <pm>
    6. --no-install
    7. --dry-run
    8. --local [path]
    9. -q, --quiet

Usage

Run create-app interactively or with flags.

Run the scaffolder through your package manager's create command:

pnpm create @lakeql/app my-api

Run without answers, and it prompts for the project name, the adapters to include, the data source names, and the authentication strategy. Every prompt has a corresponding flag, so you can run it non-interactively in scripts. For example:

pnpm create @lakeql/app my-api --adapters trino,fabric --auth entra-id

The arguments and options below come from create-app's own metadata, so they always match the installed version.

Arguments

NameDescriptionRequired
[project-name]

Project directory name

No

--adapters <ids>

Comma-separated adapter IDs (trino, fabric)

PropertyValue
Typestring
RequiredNo

--ds-names <names>

Comma-separated data source names (same order as --adapters)

PropertyValue
Typestring
RequiredNo

--auth <strategy>

Authentication strategy

PropertyValue
Typestring
Choicesmockentra-idcustom
RequiredNo

-d, --target-dir <path>

Parent directory to create the project in (default: current directory)

PropertyValue
Typestring
RequiredNo

-p, --package-manager <pm>

Package manager: npm, pnpm, yarn

PropertyValue
Typestring
RequiredNo

--no-install

Skip dependency installation

PropertyValue
Typeboolean
RequiredNo

--dry-run

Preview generated files without writing

PropertyValue
Typeboolean
RequiredNo
Defaultfalse

--local [path]

Dev mode: scaffold from a local template dir (default: <cwd>/templates/app) and keep workspace:* dependency versions

PropertyValue
Typestring
RequiredNo

-q, --quiet

Suppress all output

PropertyValue
Typeboolean
RequiredNo

Previous page

create-app

Next page

Template Structure