@percepta/create-app

Create a new Percepta app from the Next.js template.

Usage

# Interactive mode
npx @percepta/create-app

# With project directory
npx @percepta/create-app my-new-app

# With all options (non-interactive)
npx @percepta/create-app my-new-app --yes

# Skip optional steps
npx @percepta/create-app my-new-app --skip-install --skip-git

# Use different package manager
npx @percepta/create-app my-new-app --use-npm
npx @percepta/create-app my-new-app --use-yarn

Options

| Option | Description | |--------|-------------| | --name <name> | Project name (defaults to directory name) | | --title <title> | Display title (defaults to title case of name) | | --skip-install | Skip dependency installation | | --skip-git | Skip git initialization | | --use-npm | Use npm instead of pnpm | | --use-yarn | Use yarn instead of pnpm | | -y, --yes | Skip all prompts and use defaults |

What's Included

The template includes:

• Next.js 15 with App Router and Pages Router
• Authentication via NextAuth.js (Google, Okta, Ping Identity, Credentials)
• Database with PostgreSQL and Drizzle ORM
• Type-safe API with tRPC
• Background Jobs with Inngest
• Observability with OpenTelemetry and Langfuse
• Infrastructure as Code with Terraform (AWS)
• Styling with Tailwind CSS

Development

Building the CLI

pnpm build

Testing locally

# Build the CLI
pnpm build

# Link globally
npm link

# Test creating a project
create-percepta-app test-app

Syncing template files

When the base template is updated, sync the changes:

pnpm sync-template

Then manually review and update the .template files if needed:

• template/package.json.template
• template/gitignore.template
• template/env.example.template

Publishing

pnpm publish --access public