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.
Stripe CLI
We use the Stripe CLI to forward payments webhooks to your local machine.
Once installed, you can login to authenticate with your Stripe account.
stripe loginMintlify CLI
We use the Mintlify CLI to preview the docs locally.
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.