1.0.0 • Published 5 months ago
connectrix v1.0.0
README.md
Connectrix - NoSQL Connector Generator CLI 🚀
Professional CLI tool for generating production-ready NoSQL connectors with automatic environment configuration.
📦 Features
- Multi-Database Support: MongoDB, Cassandra, Couchbase, DynamoDB
- Environment First: Automatic
.env
file management - Type Safety: Built-in TypeScript definitions
- Security Focused: Never stores credentials in code
- Validation: Comprehensive input validation
- CI/CD Ready: Pre-configured testing and linting
🚀 Quick Start
Installation
npm install -g connectrix
# or
npx connectrix generate
Usage
connectrix generate
? Select database type: MongoDB
? Enter database host: localhost
? Enter database port: 27017
? Enter database name: production_db
? Enable SSL? (y/N): N
🔧 Configuration
Environment Variables
The generated .env
file follows this pattern:
DB_[DBTYPE]_HOST=your-host
DB_[DBTYPE]_PORT=your-port
DB_NAME=your-db-name
Supported Databases
Database | Template Version | Required Fields |
---|---|---|
MongoDB | 2.4.1 | host, port, ssl |
Cassandra | 1.2.0 | hosts, keyspace |
Couchbase | 1.1.0 | cluster, bucket |
DynamoDB | 1.3.0 | region, accessKeyId |
🛠 Development
Contributing
- Fork the repository
- Create feature branch:
git checkout -b feature/new-db-support
- Commit changes:
git commit -am 'Add new database support'
- Push to branch:
git push origin feature/new-db-support
- Submit pull request
Testing
npm test # Run all tests with coverage
npm run test:watch # Watch mode for TDD
Security
Report vulnerabilities via SECURITY.md
📚 Documentation
Full API documentation available at docs.connectrix
📜 License
MIT © Kunaal Gadhalay
**Key Advanced Features in package.json**:
1. **Security Tooling**: ESLint security plugin, npm audit script
2. **Modern JS Support**: ES Modules (`"type": "module"`)
3. **Release Management**: Standard-version for changelog generation
4. **Git Hooks**: Husky for pre-commit linting
5. **Type Safety**: TypeScript definitions and TS-Jest integration
6. **CI/CD Ready**: Test coverage integration with Coveralls
7. **Node Version Control**: Engines field for Node >=18
**Key Advanced Features in README.md**:
1. **Badge Ecosystem**: CI/CD, coverage, version, and license badges
2. **Visual Hierarchy**: Clear section organization with emojis
3. **Interactive Documentation**: Animated GIF demo
4. **Version Matrix**: Database support table
5. **Security Reporting**: Dedicated security section
6. **Developer Workflow**: Detailed contribution guidelines
7. **Documentation Links**: External API docs reference
This implementation follows industry best practices for:
- **Production Readiness**: Test coverage, CI/CD integration
- **Developer Experience**: TypeScript support, watch modes
- **Security**: Vulnerability scanning, secure credential handling
- **Maintainability**: Conventional commits, automated releases
- **Discoverability**: SEO-friendly keywords, proper metadata
1.0.0
5 months ago