{"id":49747,"library":"wilddog","title":"Wilddog Realtime SDK","description":"Wilddog Realtime SDK is a real-time data synchronization library for web and mobile applications, similar to Firebase Realtime Database. Version 2.5.17 is the latest stable release, with infrequent updates. It provides real-time WebSocket-based communication, offline support, and data security rules. Compared to Firebase, it offers localized service for the Chinese market. The library includes TypeScript type definitions for better developer experience.","status":"active","version":"2.5.17","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","wilddog","realtime","websocket","typescript"],"install":[{"cmd":"npm install wilddog","lang":"bash","label":"npm"},{"cmd":"yarn add wilddog","lang":"bash","label":"yarn"},{"cmd":"pnpm add wilddog","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The library exports a default object. ESM import is preferred; CJS require also works but may lack TypeScript types in some environments.","wrong":"const wilddog = require('wilddog')","symbol":"wilddog","correct":"import wilddog from 'wilddog'"},{"note":"auth is a method on the default export, not a named export.","wrong":"import { auth } from 'wilddog'","symbol":"auth","correct":"import wilddog from 'wilddog';\nwilddog.auth()"},{"note":"database() is a function on the default export.","wrong":"import { database } from 'wilddog'","symbol":"database","correct":"import wilddog from 'wilddog';\nconst database = wilddog.database()"}],"quickstart":{"code":"import wilddog from 'wilddog';\n\nconst config = {\n  syncURL: 'https://your-app.wilddogio.com',\n  authDomain: 'your-app.wilddog.com'\n};\n\nwilddog.initializeApp(config);\n\nconst ref = wilddog.database().ref('messages');\nref.on('value', (snapshot) => {\n  console.log('Data:', snapshot.val());\n});\n\nref.push({\n  user: 'alice',\n  message: 'Hello from Wilddog!'\n});","lang":"typescript","description":"Initializes the Wilddog app, connects to the realtime database, listens for value events, and pushes new data."},"warnings":[{"fix":"Use the correct syncURL from your Wilddog console (usually ends with .wilddogio.com).","message":"Wilddog SDK uses wilddogio.com as default database URL, but recent updates may require custom domains. Always check the latest documentation.","severity":"gotcha","affected_versions":">=2.5"},{"fix":"Check if app is already initialized before calling initializeApp, or use wilddog.app() to get the existing instance.","message":"Calling wilddog.initializeApp() multiple times will cause the app to overwrite previously initialized instances. Only call once per app.","severity":"gotcha","affected_versions":">=2.0"},{"fix":"Use the recommended auth methods from the latest Wilddog authentication guide.","message":"Some older methods like wilddog.auth().signInWithEmailAndPassword are deprecated in favor of newer auth methods. Check current docs.","severity":"deprecated","affected_versions":"2.5.x"},{"fix":"Accept full import or consider using alternative solutions if bundle size is critical.","message":"The SDK does not support tree-shaking; importing the entire library increases bundle size. No individual module imports available.","severity":"gotcha","affected_versions":">=1.0"}],"env_vars":null,"search_vec":"'2.5.17':26 'applic':19 'base':42 'better':68 'chines':59 'communic':43 'compar':50 'data':12,47 'databas':24 'definit':66 'develop':69 'experi':70 'firebas':22,52 'includ':63 'infrequ':33 'javascript':71 'latest':29 'librari':14,62 'local':55 'market':60 'mobil':18 'offer':54 'offlin':44 'provid':36 'real':10,38 'real-tim':9,37 'realtim':2,5,23,73 'releas':31 'rule':49 'sdk':3,6 'secur':48 'servic':56 'similar':20 'stabl':30 'support':45 'synchron':13 'time':11,39 'type':65 'typescript':64,75 'updat':34 'version':25 'web':16 'websocket':41,74 'websocket-bas':40 'wilddog':1,4,72","created_at":"2026-06-07T17:03:24.188002+00:00","updated_at":"2026-06-07T17:03:24.188002+00:00","problems":[{"fix":"Call wilddog.initializeApp(config) with a valid configuration object.","cause":"initializeApp was not called before using Wilddog services.","error":"Error: Wilddog: Must initialize app with a valid config."},{"fix":"Wrap primitive data in an object: ref.push({ value: data })","cause":"Attempted to push non-object data (e.g., string, number).","error":"Error: Reference.push failed: First argument must be an object."},{"fix":"Update database security rules to allow read/write from the client, or authenticate properly.","cause":"Security rules on the database reject the operation.","error":"Error: permission_denied at /messages: Client doesn't have permission to access the desired data."},{"fix":"npm uninstall wildgod && npm install wilddog","cause":"Typo in package name: installed 'wildgod' instead of 'wilddog'.","error":"TypeError: wildgod.database is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"wilddog","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}