Skip to main content

​
Requirements

  • React 18 or higher
  • TypeScript 5 or higher

​
Installation

Install the Privy React SDK with a supported package manager: 
npm install @privy-io/react-auth@latest
If your app uses Privy’s Solana wallets, install the following peer dependencies:
  • @solana/kit
  • @solana-program/memo
  • @solana-program/system
  • @solana-program/token
For webpack, add these packages to the externals config. Skip this step for Turbopack:
// webpack.config.js
module.exports = {
  //...
  externals: {
    ['@solana/kit']: 'commonjs @solana/kit',
    ['@solana-program/memo']: 'commonjs @solana-program/memo',
    ['@solana-program/system']: 'commonjs @solana-program/system',
    ['@solana-program/token']: 'commonjs @solana-program/token'
  }
};

// next.config.js
module.exports = {
  webpack: (config) => {
    // ...
    config.externals['@solana/kit'] = 'commonjs @solana/kit';
    config.externals['@solana-program/memo'] = 'commonjs @solana-program/memo';
    config.externals['@solana-program/system'] = 'commonjs @solana-program/system';
    config.externals['@solana-program/token'] = 'commonjs @solana-program/token';
    return config;
  }
};
If build errors remain, see the Vite troubleshooting guide. One example is getTransferSolInstruction export errors.
Vite resolves string-literal dynamic imports during dependency optimization, so optional or environment-specific packages must be installed for builds to pass. These packages are not included in the main runtime bundle; they are loaded only when the dynamic import path is used.