Prerequisites
How to configure your development environment for next-forge.
Operating System
next-forge is designed to work on macOS, Linux and Windows. While next-forge itself is platform-agnostic, the tooling and dependencies we use have different requirements.
We’ve tested and confirmed that next-forge works on the following combinations of operating systems, Node.js versions and next-forge versions:
| Operating system | next-forge version | Node.js version | Notes |
|---|---|---|---|
| macOS Sequoia 15.0.1 (24A348) | 2.14.3 | 20.12.2 | |
| Ubuntu 24.04 Arm64 | 2.14.3 | 20.18.0 | |
| Fedora, Release 41 | 2.14.3 | 22.11.0 | |
| Windows 11 Pro 24H2 (26100.2033) | 2.14.3 | 20.18.0 | Turborepo only supports specific architectures. windows ia32 is not supported. |
We’re aware of issues on non-Ubuntu Linux distributions. While we don’t officially support them, we’d love to know if you get it working!
Package Manager
next-forge defaults to using pnpm as a package manager, but you can use npm, yarn or bun instead by passing a flag during the installation step.
Install pnpm
Install pnpm for your operating system.
Stripe CLI
We use the Stripe CLI to forward payments webhooks to your local machine.
Install the Stripe CLI
Install the Stripe CLI for your operating system.
Once installed, you can login to authenticate with your Stripe account.
Mintlify CLI
We use the Mintlify CLI to preview the docs locally.
Install the Mintlify CLI
Install the Mintlify CLI.
Accounts
next-forge relies on various SaaS products. You will need to create accounts with the following services then set the API keys in your environment variables:
- Arcjet, for application security.
- BetterStack, for logging and uptime monitoring.
- Clerk, for authentication.
- Google Analytics, for web analytics.
- Posthog, for product analytics.
- Resend, for transactional emails.
- Sentry, for error tracking.
- Stripe, for payments.