iqtoolkit.ai

Official website for iqtoolkit.ai - Self-hosted, multi-database intelligence platform.

Repository for the marketing website of iqtoolkit.ai - a unified, open-source database intelligence platform for MongoDB, PostgreSQL, and beyond. Built by a DBA-turned-architect to solve the fragmentation of multi-database operations.

🎯 About iqtoolkit

iqtoolkit is a self-hosted only platform that brings AI-powered query analysis and performance insights to multiple database types. Currently in development with v0.2.0-alpha launching December 2025.

Key Differentiators:

• 🔒 Self-Hosted Only - Deploy on YOUR infrastructure (Docker, Kubernetes, on-premises)
• 🗄️ Multi-Database - MongoDB + PostgreSQL from day one (MySQL, SQL Server in Q2 2026)
• 🤖 AI Choice - Ollama (private, on-premises) OR OpenAI (cloud, managed)
• 🌐 Open Source - MIT/Apache 2.0 license, no vendor lock-in
• 👨‍💻 DBA-Built - Designed by someone who lived the operational pain

🚀 Website Features

• ⚡ Next.js 16 - Latest React framework with App Router
• 🎨 Tailwind CSS 4 - Modern utility-first CSS framework
• 📱 Responsive Design - Mobile-first, works on all devices
• ♿ Accessibility - WCAG compliant
• 🔍 SEO Optimized - Meta tags, sitemap, robots.txt
• 📧 Newsletter Integration - EmailOctopus API for alpha testing waitlist
• 📝 MDX Blog - Technical blog with syntax highlighting
• 🧪 Testing - Jest & React Testing Library
• 📊 Code Coverage - Automated coverage reporting
• 🔧 TypeScript - Type-safe code
• 💅 Prettier - Consistent code formatting
• 🔒 ESLint - Code quality and best practices
• 🚦 Lighthouse CI - Automated performance monitoring
• 🤖 Dependabot - Automated dependency updates
• 🔄 CI/CD - GitHub Actions automated workflows

🏗️ Tech Stack

• Framework: Next.js 16 with React 19
• Styling: Tailwind CSS 4
• Language: TypeScript 5
• Testing: Jest, React Testing Library
• Linting: ESLint with Next.js config
• Formatting: Prettier
• CI/CD: GitHub Actions
• Deployment: Netlify
• Package Manager: npm

📋 Prerequisites

• Node.js >= 18.0.0
• npm >= 9.0.0

🛠️ Installation

1. Clone the repository:

git clone https://github.com/iqtoolkit/iqtoolkit.ai.git
cd iqtoolkit.ai

2. Install dependencies:

npm install

3. Set up environment variables (for newsletter):

cp .env.example .env.local

Edit .env.local and add your EmailOctopus credentials. See docs/EMAILOCTOPUS_SETUP.md for details.

4. Run the development server:

npm run dev

5. Open http://localhost:3000 in your browser.

📝 Available Scripts

Command	Description
npm run dev	Start development server
npm run build	Build production bundle
npm start	Start production server
npm run lint	Run ESLint
npm run lint:fix	Fix ESLint errors
npm run format	Format code with Prettier
npm run format:check	Check code formatting
npm run type-check	Run TypeScript type checking
npm test	Run tests
npm run test:watch	Run tests in watch mode
npm run test:coverage	Run tests with coverage
npm run validate	Run all checks (format, lint, type-check, build)

🧪 Testing

Run the test suite:

npm test

Run tests in watch mode:

npm run test:watch

Generate coverage report:

npm run test:coverage

🚀 Deployment

This site is automatically deployed to Netlify when changes are pushed to the main branch.

Manual Deployment

1. Build the project:

npm run build

2. The build output will be in the .next directory.

Netlify Configuration

The site is configured to deploy automatically via Netlify. Build settings:

• Build Command: npm run build
• Publish Directory: .next
• Node Version: 20.x

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Run validation before committing (npm run validate)
4. Commit your changes (git commit -m 'Add some amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

Please review and adhere to our Code of Conduct. By participating in this project, you agree to uphold this standard.

Code Quality

All code must pass the following checks before being merged:

• ✅ Prettier formatting
• ✅ ESLint rules
• ✅ TypeScript type checking
• ✅ All tests passing
• ✅ Build successful

Run all checks at once:

npm run validate

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Next.js
• Styled with Tailwind CSS
• Deployed on Netlify

📧 Contact

For questions or support, please open an issue in this repository.

---

Made with ❤️ by iqtoolkit