Deployment
How to deploy Notiq and its documentation to production.
Deployment
Deploying the Documentation
The Notiq documentation is built with Next.js and Fumadocs. It is optimized for deployment on Vercel but can be hosted on any platform that supports Next.js.
Vercel (Recommended)
The easiest way to deploy is using the Vercel integration.
- Push your code to a GitHub repository.
- Connect the repository to Vercel.
- Add the required environment variables:
OPENAI_API_KEY: Your OpenAI key (starting withsk-).NEXT_PUBLIC_BASE_URL: The production URL of your docs.
Build Command
If you are deploying elsewhere:
pnpm buildThis will generate a production-ready .next folder.
Deploying the Editor (Library)
If you are using Notiq as a library in your own app, follow these steps for production safety:
Bundle Optimization
Notiq uses dynamic imports for heavy plugins (Excalidraw, Figma). Ensure your bundler (webpack/vite) is configured for code splitting.
Style Injection
Make sure to import the Notiq styles in your main entry point:
import "@collabchron/notiq/styles.css";Server-Side Rendering (SSR)
Notiq is a client-side library. If you use it in a Next.js app, ensure you import the Editor component using next/dynamic with ssr: false:
const Editor = dynamic(() => import("@collabchron/notiq"), { ssr: false });CI/CD Tips
- Linting: Run
pnpm lintbefore every deploy. - Type Checking: Run
tsc --noEmitto ensure type safety in production.