skills.rest
authgear
authgearOFFICIAL
Explore all skills by this author →
Website𝕏@authgearGitHub

bootstrap-local-dev

Guides first-time setup of the authgear-server development environment on macOS.

2.0k|126|Updated Jun 16, 2020
Search Tags:#dev environment#local development#Onboarding#Homebrew#ASDF#authgear#Setup
One-click install
npx skills add https://github.com/authgear/authgear-server --skill bootstrap-local-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bootstrap-local-dev
Source: https://github.com/authgear/authgear-server/tree/main/.claude/skills/bootstrap-local-dev
Command: npx skills add https://github.com/authgear/authgear-server --skill bootstrap-local-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up the authgear-server repository from scratch involves many ordered steps—installing pinned tool versions, Homebrew dependencies, building frontends, and provisioning databases—where a single missed step causes confusing failures. This Skill walks a new contributor through the entire bootstrap process with verification at each stage.

Core Features & Use Cases

  • Guided step-by-step setup: Runs asdf installs, Homebrew dependency checks, make vendor, and make setup in order, verifying each step before continuing.
  • Failure containment: Stops on the first error and reports it verbatim so the user can fix the root cause instead of compounding problems.
  • Environment configuration: Generates the exact shell exports (PATH, PKG_CONFIG_PATH, CGO flags) needed for builds to work on macOS.
  • Use Case: A new contributor clones authgear-server on a fresh Mac and asks the AI to set up local dev; the Skill provisions Postgres, Redis, MinIO, runs migrations, and creates the bootstrap admin account, ending with working Portal and Auth UI servers.

Quick Start

Ask the AI to set up the authgear-server local development environment from scratch on this machine.

Frequently Asked Questions about bootstrap-local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up authgear-server local development from scratch?▼

Run the guided bootstrap which installs pinned Go, Node.js, and Python via asdf, installs Homebrew dependencies, then runs make vendor and make setup. The setup script provisions Postgres, Redis, and MinIO, runs migrations, and creates a bootstrap admin account.

What are the default authgear-server local dev credentials?▼

The default bootstrap credentials are [email protected] with password 'password'. You can override them by setting ADMIN_EMAIL and ADMIN_PASSWORD environment variables before running make setup.

Does the authgear-server setup work on Linux or with Nix?▼

The guided bootstrap assumes macOS with asdf and Homebrew; on Linux the Homebrew steps need adaptation. Nix Flakes users should follow the CONTRIBUTING.md Nix installation instructions instead of this workflow.

Why does authgear-server build fail with pkg-config or icu4c errors?▼

Builds fail when the required shell exports are missing: PATH must include GNU make's gnubin, and PKG_CONFIG_PATH must point to Homebrew's icu4c pkgconfig directory. Verify with make --version showing GNU Make 4.x and pkg-config --modversion icu-i18n succeeding.

When should I not re-run make vendor in authgear-server?▼

make vendor is only for first-time setup since it rebuilds vendored dependencies and both frontends, taking 5-15 minutes. For routine restarts, use the 'Start local dev' recipe in AGENTS.md with make start, make start-portal, and the portal npm start.

Related Skills

Explore More Software Engineering Skills→
reverb256reverb256

container-native

Manage Docker and Podman containers and images on NixOS.

Community
Intermediate
caseymanoscaseymanos

local-ssl

Automates creation and trust of local SSL certificates for development environments.

Community
Advanced
hardisgroupcomhardisgroupcom
368

test

Build, lint, and test code changes with yarn commands.

Official
Intermediate
olafkfreundolafkfreund
9

NixOS Development

Configure reproducible NixOS dev shells with Nix Flakes and direnv.

Community
Advanced