{"id":18942,"library":"yekonga-server","title":"Yekonga Server","description":"Yekonga Server v4.4.3 is an open-source Node.js backend framework built on Express and Socket.IO, providing REST, GraphQL, CLI scaffolding, and cloud functions. It integrates GraphQL with an optional authQuery, configurable permissions, database modeling, and mail (SMTP) support. Requires Node >=21.0.0. Differentiators: opinionated CLI (create, generate triggers), JSON configuration, and built-in GraphQL auth. Release cadence is irregular.","status":"active","version":"4.4.3","language":"javascript","source_language":"en","source_url":"https://github.com/robertkonga/yekonga-server","tags":["javascript","yekonga","graphql","express","socket-io","framework","cli","web","rest"],"install":[{"cmd":"npm install yekonga-server","lang":"bash","label":"npm"},{"cmd":"yarn add yekonga-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add yekonga-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Web framework dependency","package":"express","optional":false},{"reason":"Real-time communication","package":"socket.io","optional":false}],"imports":[{"note":"CJS-only; no default export for ESM","wrong":"import Yekonga from 'yekonga-server'; // ESM not supported","symbol":"default","correct":"const Yekonga = require('yekonga-server');"},{"note":"Direct require returns the constructor","wrong":"const Yekonga = require('yekonga-server').default; // No .default","symbol":"Yekonga","correct":"const Yekonga = require('yekonga-server');"},{"note":"Must use new Yekonga() after require","wrong":"import { Yekonga } from 'yekonga-server'; // Named export not available","symbol":"Yekonga class","correct":"const Yekonga = require('yekonga-server'); const app = new Yekonga();"}],"quickstart":{"code":"const Yekonga = require('yekonga-server');\nconst config = {\n  app: { title: 'My App', version: '1.0.0' },\n  permissions: { default: 'public' },\n  database: { users: { fields: { name: 'string', email: 'string' } } }\n};\nconst app = new Yekonga(config);\napp.start(3000, () => console.log('Server running on port 3000'));","lang":"javascript","description":"Create a Yekonga server instance with inline config JSON and start on port 3000."},"warnings":[{"fix":"Update Node to v21 or later","message":"Node >=21.0.0 required since v4.0.0","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Use new Yekonga(config) instead","message":"Yekonga.setConfig() deprecated, pass config in constructor","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Ensure graphql.authQuery returns a valid query string","message":"GraphQL authQuery misconfiguration breaks auth","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use require() syntax; do not import package in ES modules","message":"CJS-only; no ESM support","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure installed socket.io version matches peer dependency","message":"Socket.IO version mismatch may cause runtime errors","severity":"breaking","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install yekonga-server' in your project root","cause":"Package not installed or node_modules missing","error":"Cannot find module 'yekonga-server'"},{"fix":"Add 'const Yekonga = require('yekonga-server');' at the top","cause":"Missing require('yekonga-server')","error":"Yekonga is not defined"},{"fix":"Include 'app: { title: ... }' in config","cause":"Config object missing app property","error":"Error: config.app is required"},{"fix":"Use 'new Yekonga(config)' directly","cause":"setConfig removed in v3+, use constructor","error":"TypeError: Yekonga.setConfig is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}