--- title: "Creart Node.js WHOIS Software" canonical: https://hamzadenizyilmaz.com.tr/projeler/creart-nodejs-whois author: "Hamza Deniz Y\u0131lmaz" created: 2026-07-23T02:34:57.8980839+00:00 published: 2026-07-23T02:34:57.8980839+00:00 --- # Creart Node.js WHOIS Software ## Creart-Whois - Comprehensive WHOIS Lookup Platform ![WHOIS Lookup](https://img.shields.io/badge/WHOIS-Lookup-blue) ![Node.js](https://img.shields.io/badge/Node.js-18%2B-green) ![Next.js](https://img.shields.io/badge/Next.js-14%2B-black) ![License](https://img.shields.io/badge/License-MIT-yellow) ![Version](https://img.shields.io/badge/Version-1.2.5--beta-orange) ![](https://img.shields.io/github/license/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/repo-size/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/commit-activity/m/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/last-commit/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/languages/top/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/issues/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) ![](https://img.shields.io/github/issues-pr/hamzadenizyilmaz/Creart-Node.JS-Whois-Software) **Creart-Whois** is a modern WHOIS lookup platform for querying domains, IPv4, IPv6, ASN, and CIDR. Powered by **Node.js 18+**, **Next.js 14+**, **Tailwind CSS**, and **Framer Motion**, it delivers a fast, secure, and extensible solution with a sleek, responsive interface. As the **first beta release (v1.2.5-beta)**, we’re excited to share this with the community and welcome feedback to shape its future\! ## πŸš€ Features ### πŸ” Query Capabilities - **Domain WHOIS**: Detailed registrar, ownership, and name server data. - **IPv4/IPv6 Lookup**: Geolocation, ISP, and security details. - **ASN Queries**: Autonomous System Number details, including provider and routing. - **CIDR Blocks**: Subnet and IP range analysis. - **DNS Records**: Support for A, AAAA, MX, CNAME, TXT, and more. ### πŸ’» Technical Highlights - **Tech Stack**: Node.js (backend), Next.js 14+ (frontend), Tailwind CSS, Framer Motion. - **Real-Time Queries**: Optimized for speed with caching support. - **Responsive UI**: Mobile, tablet, and desktop compatibility. - **RESTful API**: Developer-friendly with rate limiting and caching. - **Security**: Helmet, CORS, Joi validation, XSS/SQL injection protection. - **Performance**: SSR/SSG, Gzip/Brotli compression, Redis/node-cache. ### 🎨 User Experience - **Modern Design**: Glass-morphism, gradients, 60 FPS animations. - **Dark/Light Mode**: Auto-switching themes. - **Smart Search**: Autocomplete, suggestions, and history. - **Reports**: Formatted or raw data views. - **Accessibility**: ARIA-compliant for inclusivity. ## πŸ“ Project Structure ``` Creart-Node.JS-Whois-Software/ β”œβ”€β”€ πŸ“ backend/ # Node.js API Server β”‚ β”œβ”€β”€ πŸ“ config/ # Configuration β”‚ β”‚ └── constants.js # App constants β”‚ β”œβ”€β”€ πŸ“ middleware/ # Express middleware β”‚ β”‚ β”œβ”€β”€ validation.js # Joi schemas β”‚ β”‚ β”œβ”€β”€ rateLimit.js # Rate limiting β”‚ β”‚ β”œβ”€β”€ errorHandler.js # Error handling β”‚ β”‚ β”œβ”€β”€ cache.js # Redis/node-cache β”‚ β”‚ └── asyncHandler.js # Async error handler β”‚ β”œβ”€β”€ πŸ“ routes/ # API routes β”‚ β”‚ β”œβ”€β”€ whois.js # WHOIS endpoints β”‚ β”‚ β”œβ”€β”€ dns.js # DNS endpoints β”‚ β”‚ └── health.js # Health checks β”‚ β”œβ”€β”€ πŸ“ utils/ # Utilities β”‚ β”‚ β”œβ”€β”€ whoisParser.js # WHOIS parser β”‚ β”‚ β”œβ”€β”€ ipTools.js # IP utilities β”‚ β”‚ β”œβ”€β”€ responseFormatter.js # Response formatting β”‚ β”‚ β”œβ”€β”€ database.js # DB utilities β”‚ β”‚ └── cache.js # Cache management β”‚ β”œβ”€β”€ package.json # Dependencies β”‚ └── server.js # Main server β”œβ”€β”€ πŸ“ frontend/ # Next.js Application β”‚ β”œβ”€β”€ πŸ“ components/ # React components β”‚ β”‚ β”œβ”€β”€ πŸ“ Layout/ # Layout components β”‚ β”‚ β”‚ β”œβ”€β”€ Layout.js # Main layout β”‚ β”‚ β”‚ β”œβ”€β”€ Header.js # Navigation β”‚ β”‚ β”‚ └── Footer.js # Footer β”‚ β”‚ β”œβ”€β”€ πŸ“ Search/ # Search components β”‚ β”‚ β”‚ β”œβ”€β”€ SearchForm.js # Search form β”‚ β”‚ β”‚ └── QueryTypes.js # Query type selector β”‚ β”‚ β”œβ”€β”€ πŸ“ Results/ # Result components β”‚ β”‚ β”‚ β”œβ”€β”€ ResultDisplay.js # Results view β”‚ β”‚ β”‚ β”œβ”€β”€ DomainInfo.js # Domain display β”‚ β”‚ β”‚ β”œβ”€β”€ IPInfo.js # IP display β”‚ β”‚ β”‚ └── RawData.js # Raw data view β”‚ β”‚ └── πŸ“ UI/ # UI components β”‚ β”‚ β”œβ”€β”€ Button.js # Buttons β”‚ β”‚ β”œβ”€β”€ Loading.js # Loading animations β”‚ β”‚ └── ErrorMessage.js # Error messages β”‚ β”œβ”€β”€ πŸ“ pages/ # Next.js pages β”‚ β”‚ β”œβ”€β”€ index.js # Homepage β”‚ β”‚ β”œβ”€β”€ _app.js # App wrapper β”‚ β”‚ └── πŸ“ api/ # API routes β”‚ β”‚ └── hello.js # Sample route β”‚ β”œβ”€β”€ πŸ“ styles/ # Styles β”‚ β”‚ └── globals.css # Global CSS & Tailwind β”‚ β”œβ”€β”€ πŸ“ utils/ # Frontend utilities β”‚ β”‚ β”œβ”€β”€ api.js # API calls β”‚ β”‚ └── formatters.js # Data formatters β”‚ β”œβ”€β”€ public/ # Static assets β”‚ β”œβ”€β”€ next.config.js # Next.js config β”‚ β”œβ”€β”€ tailwind.config.js # Tailwind config β”‚ β”œβ”€β”€ postcss.config.js # PostCSS config β”‚ └── package.json # Dependencies β”œβ”€β”€ πŸ“ docs/ # Documentation β”œβ”€β”€ πŸ“ scripts/ # Deployment scripts β”œβ”€β”€ LICENSE # MIT License └── README.md # This file ``` ## πŸ› οΈ Installation ### Prerequisites - **Node.js**: 18.0+ - **npm**: 9.0+ - **Git** - Optional: **Docker**, **Redis**, **MongoDB** ### πŸƒβ€β™‚οΈ Local Setup 1. **Clone Repository**: ```bash git clone https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software.git cd Creart-Node.JS-Whois-Software ``` 2. **Backend Setup**: ```bash cd backend npm install cp .env.example .env ``` Edit ` .env `: ```env NODE_ENV=development PORT=3001 FRONTEND_URL=http://localhost:3000 MONGODB_URI=mongodb+srv://test:test@test.mongodb.net/ RATE_LIMIT_WINDOW_MS=900000 RATE_LIMIT_MAX_REQUESTS=100 ``` 3. **Frontend Setup**: ```bash cd frontend npm install ``` 4. **Run Application**: - **Backend**: ```bash cd backend npm start ``` Output: ``` WHOIS API Server Started! Port: 3001 Environment: development API URL: http://localhost:3001/api/v1 Health Check: http://localhost:3001/health ``` - **Frontend**: ```bash cd frontend npm run dev ``` Output: ``` β–² Next.js 14.2.33 Local: http://localhost:3000 ``` 5. **Test**: - Frontend: ` http://localhost:3000 ` - API: ` http://localhost:3001/api/v1 ` - Health Check: ` http://localhost:3001/health ` ### 🌐 Production Deployment #### Environment - **Backend ` .env `**: ```env NODE_ENV=production PORT=3001 FRONTEND_URL=https://yourdomain.com MONGODB_URI=mongodb+srv://test:test@test.mongodb.net/ RATE_LIMIT_WINDOW_MS=900000 RATE_LIMIT_MAX_REQUESTS=100 ``` #### Build - **Backend**: ```bash cd backend npm run build npm start ``` - **Frontend**: ```bash cd frontend npm run build npm start # Or static export: npm run build && npm run export ``` #### Deployment Options ##### A) VPS (Ubuntu 20.04+) ```bash ssh user@your-server-ip sudo apt update && sudo apt upgrade -y curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs sudo apt install nginx -y sudo npm install -g pm2 git clone https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software.git cd Creart-Node.JS-Whois-Software cd backend npm install --production pm2 start server.js --name "whois-backend" cd ../frontend npm install --production npm run build ``` **Nginx Config** (` /etc/nginx/sites-available/whois-app `): ```nginx server { listen 80; server_name api.yourdomain.com; location / { proxy_pass http://localhost:3001; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } server { listen 80; server_name yourdomain.com www.yourdomain.com; root /path/to/Creart-Node.JS-Whois-Software/frontend/out; index index.html; gzip on; gzip_types text/plain text/css application/json application/javascript; location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { expires 1y; add_header Cache-Control "public, immutable"; } location / { try_files $uri $uri/ /index.html; } } ``` ##### B) Docker **` docker-compose.yml `**: ```yaml version: '3.8' services: backend: build: ./backend ports: - "3001:3001" environment: - NODE_ENV=production - MONGODB_URI=mongodb://mongodb:27017/whois-app - REDIS_URL=redis://redis:6379 depends_on: - mongodb - redis volumes: - ./backend:/app - /app/node_modules restart: unless-stopped frontend: build: ./frontend ports: - "3000:3000" environment: - NEXT_PUBLIC_API_URL=http://localhost:3001 depends_on: - backend restart: unless-stopped mongodb: image: mongo:6.0 ports: - "27017:27017" volumes: - mongodb_data:/data/db restart: unless-stopped redis: image: redis:7.2-alpine ports: - "6379:6379" volumes: - redis_data:/data restart: unless-stopped volumes: mongodb_data: redis_data: ``` Run: ```bash docker-compose up -d ``` ##### C) PaaS - **Vercel (Frontend)**: ```bash cd frontend npm i -g vercel vercel --prod ``` - **Railway/Heroku (Backend)**: ```bash cd backend railway add railway deploy ``` ## πŸ”§ API Documentation ### Base URL - Development: ` http://localhost:3001/api/v1 ` - Production: ` https://api.yourdomain.com/api/v1 ` ### Endpoints #### πŸ” WHOIS Lookup **POST** ` /whois ` - **Request**: ```json { "query": "example.com", "type": "domain" } ``` - **Response**: ```json { "success": true, "data": { "domainName": "example.com", "registrar": "Example Registrar", "creationDate": "1995-08-13T00:00:00Z", "expiryDate": "2026-08-12T00:00:00Z", "nameServers": ["ns1.example.com", "ns2.example.com"], "status": "clientTransferProhibited" }, "metadata": { "responseTime": "245ms", "cached": false, "timestamp": "2025-10-22T02:10:00Z" } } ``` #### 🌐 DNS Lookup **POST** ` /dns ` - **Request**: ```json { "domain": "example.com", "recordType": "A" } ``` - **Response**: ```json { "success": true, "data": { "domain": "example.com", "recordType": "A", "records": ["93.184.216.34"] } } ``` #### πŸ“Š Batch Query **POST** ` /whois/batch ` - **Request**: ```json { "queries": [ {"query": "example.com", "type": "domain"}, {"query": "8.8.8.8", "type": "ipv4"}, {"query": "AS15169", "type": "asn"} ] } ``` - **Response**: ```json { "success": true, "data": [{ "query": "example.com", "type": "domain", "result": {...} }, ...] } ``` #### ❀️ Health Check **GET** ` /health ` - **Response**: ```json { "status": "healthy", "timestamp": "2025-10-22T02:10:00Z", "uptime": 12345.67, "version": "1.2.5-beta" } ``` ### Query Types | Type | Format | Example | Description | | --- | --- | --- | --- | | ` domain ` | FQDN | ` example.com ` | Domain WHOIS info | | ` ipv4 ` | IPv4 Address | ` 8.8.8.8 ` | IPv4 details | | ` ipv6 ` | IPv6 Address | ` 2001:4860:4860::8888 ` | IPv6 details | | ` asn ` | AS Number | ` AS15169 ` or ` 15169 ` | ASN info | | ` cidr ` | CIDR Notation | ` 192.168.1.0/24 ` | CIDR block info | ## 🎨 Customization ### Theme Edit ` frontend/tailwind.config.js `: ```javascript module.exports = { theme: { extend: { colors: { primary: { 500: '#your-custom-color' } } } } }; ``` ### Branding Update ` frontend/components/Layout/Header.js `: ```javascript const Header = () => ( ![Creart-Whois](/path/to/your-logo.png) Your Custom App Name ); ``` ### New Query Types 1. Add to ` backend/config/constants.js ` (` SUPPORTED_QUERY_TYPES `). 2. Create parser in ` backend/utils/whoisParser.js `. 3. Update UI in ` frontend/components/Search/QueryTypes.js `. ## πŸ”’ Security - **Rate Limiting**: Per-IP query limits. - **CORS**: Trusted domains only. - **Input Validation**: Joi schemas. - **Helmet**: Security headers. - **XSS/SQL Protection**: Sanitization and parameterized queries. ## πŸ“Š Performance - **Backend**: 5-min cache, Gzip/Brotli, connection pooling, cluster mode. - **Frontend**: SSR/SSG, image optimization, code splitting, CDN-ready. ## πŸ› Troubleshooting ### Issues 1. **Backend Failure**: ```bash netstat -tulpn | grep :3001 pkill -f node cd backend && npm start ``` 2. **CORS Errors**: Check ` backend/.env `: ```env FRONTEND_URL=http://localhost:3000 ``` 3. **Timeouts**: Edit ` backend/utils/whoisParser.js `: ```javascript const WHOIS_CONFIG = { timeout: 30000, retries: 3 }; ``` 4. **Memory Usage**: ```bash pm2 start server.js --name "whois-backend" --max-memory-restart 512M ``` ### Logs - **Backend**: ```bash cd backend && npm run dev pm2 logs whois-backend ``` - **Frontend**: ```bash cd frontend && npm run build # Check browser console (F12) ``` ## 🀝 Contributing 1. **Fork & Clone**: ```bash git clone https://github.com/your-username/Creart-Node.JS-Whois-Software.git ``` 2. **Branch**: ```bash git checkout -b feature/your-feature ``` 3. **Commit**: ```bash git add . git commit -m "feat: your feature description" ``` 4. **Push & PR**: ```bash git push origin feature/your-feature ``` ### Standards - **ESLint**: Airbnb style. - **Prettier**: Code formatting. - **Commits**: Conventional (e.g., ` feat: `, ` fix: `). - **Tests**: Jest. ### Testing ```bash cd backend && npm test cd frontend && npm test npm run test:e2e ``` ## πŸ“ˆ Monitoring - **Health**: ```bash curl http://localhost:3001/health ``` - **Metrics**: ```bash curl http://localhost:3001/api/v1/stats ``` ## πŸ”„ Maintenance - **Updates**: ```bash cd backend && npm update cd frontend && npm update npm audit fix ``` - **Backup**: ```bash mongodump --uri="mongodb://localhost:27017/whois" --out=./backup/ cp .env .env.backup git tag v1.2.5-beta-backup git push --tags ``` ## πŸ“ž Support - **GitHub**: [Issues](https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software/issues) - **Email**: [hamza@creartcloud.com](mailto:hamza@creartcloud.com) ## πŸ“„ License [MIT License](https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software/blob/HEAD/LICENSE) ## πŸ™ Acknowledgments - WHOIS Protocol (ISC) - Node.js, Next.js, Tailwind CSS, Framer Motion --- **⭐ Star us on [GitHub](https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software)\!** Join us to build the future of WHOIS lookups\! πŸš€ ## Creart Node.js WHOIS Software β€” kaynak ve uygulama notlarΔ± ### Proje ve belgeyi birlikte değerlendirin Bu kayΔ±t iΓ§in kaynak aΓ§Δ±klama korunmuştur. Kurulum, bağımlΔ±lΔ±k ve lisans kararlarΔ±nda bu kayda bağlΔ± proje ve dokΓΌmanΔ± birlikte inceleyin; doğrulanmamış sΓΌrΓΌm, ΓΆlçüm veya ΓΆzellik bu ekle ilan edilmemiştir. ### Metinde geΓ§en depo bağlantΔ±larΔ± - [Depo bağlantΔ±sΔ±](https://github.com/hamzadenizyilmaz/Creart-Node.JS-Whois-Software.git) - [Depo bağlantΔ±sΔ±](https://github.com/your-username/Creart-Node.JS-Whois-Software.git) ### Δ°lgili okuma yolu - [Creart-Node.JS-Whois-Software Proje DokΓΌmanΔ±](/dokumanlar/github-creart-node-js-whois-software) - [Creart-Backup-and-Management-Software Proje DokΓΌmanΔ±](/dokumanlar/github-creart-backup-and-management-software) - [Creart Backup and Management Software](/projeler/creart-backup-management)