Skip to main content

Prerequisites

Before you begin, ensure you have the following installed on your development machine.

Required Software​

Node.js 18+​

The Vertical Template requires Node.js 18 or later.

# Check your Node.js version
node --version
# Should output: v18.x.x or higher

Installation Options:

npm 9+​

npm comes with Node.js. Verify you have version 9+:

npm --version
# Should output: 9.x.x or higher

Git​

Git is required for version control.

git --version
# Should output: git version 2.x.x

Installation:

  • macOS: xcode-select --install or brew install git
  • Windows: Download Git for Windows
  • Linux: sudo apt install git (Debian/Ubuntu)

VS Code​

We recommend Visual Studio Code with these extensions:

  • ESLint - JavaScript/TypeScript linting
  • Prettier - Code formatting
  • Tailwind CSS IntelliSense - CSS class autocomplete
  • TypeScript Vue Plugin (Volar) - If using Vue components

Terminal​

Azure/Entra ID Requirements​

To use authentication features, you'll need:

  1. Azure subscription with Entra ID (formerly Azure AD)
  2. App registration in Entra ID with:
    • Client ID
    • Client Secret
    • Tenant ID
    • Redirect URI: http://localhost:3000/api/auth/callback/azure-ad

See Environment Configuration for detailed setup.

Optional: For Anonymous API Access​

If you need public API features without user sign-in:

  1. Client Credentials Flow app registration
  2. API permissions for the Public API scope
  3. Admin consent granted

See Public API Access for details.

System Requirements​

RequirementMinimumRecommended
RAM4 GB8 GB+
Disk Space2 GB5 GB+
OSmacOS 10.15+, Windows 10+, LinuxLatest versions

Verification Checklist​

Before proceeding to the Quickstart, verify:

  • Node.js 18+ installed (node --version)
  • npm 9+ installed (npm --version)
  • Git installed (git --version)
  • Entra ID credentials ready (or skip auth for initial exploration)
  • Terminal/command line access working

Next Steps​

Once prerequisites are met: