Get Started
Two ways to set up authentication. Choose the method that fits your workflow.
Unlock @three-blocks/core and advanced compute components with an active subscription.
Select the authentication approach that works best for your development workflow.
Add a preinstall hook to your package.json. Authentication runs automatically before every install—perfect for teams and CI/CD.
Run a simple command when you need to authenticate. Great for local development and learning how it works.
Set up once, works everywhere. Perfect for production deployments.
@three-blocks:registry=https://three-blocks-196905988268.d.codeartifact.ap-northeast-1.amazonaws.com/npm/core/✅ Safe to commit - This file contains no secrets
Indie Plan:
https://three-blocks-196905988268.d.codeartifact.ap-northeast-1.amazonaws.com/npm/core/ Pro / Company Plan:
https://three-blocks-196905988268.d.codeartifact.ap-northeast-1.amazonaws.com/npm/pro/ {
"scripts": {
"preinstall": "npx -y three-blocks-login@latest"
}
}💡 Using pnpm? Use pnpm dlx three-blocks-login@latest
THREE_BLOCKS_SECRET_KEY=tb_your-license-key-here⚠️ Never commit - Add .env.local to your .gitignore
🎉
You're all set!
Run pnpm install and the preinstall hook handles the rest.
Run the CLI and it will prompt for your license key.
The CLI will prompt for your license key and configure everything automatically.
pnpm dlx three-blocks-login💡 The CLI configures your .npmrc with the registry URL and auth token.
pnpm install @three-blocks/core✨
Done!
You're authenticated and ready to go.
If you see auth errors, just run pnpm dlx three-blocks-login again to refresh your token.
Detailed setup for Vercel, GitHub Actions, Netlify, and more
View full guide →Fix common 401 errors and authentication issues
Get help →Explore the complete API reference and guides
Browse docs →See Three Blocks in action with live demos
View examples →import * as THREE from 'three/webgpu';
import { Boids, SPH, Text } from '@three-blocks/core';
// Start building amazing Three.js experiences!