Welcome to esp-jsondb Discussions!

[zekageri]

👋 Welcome to esp-jsondb Discussions!

We use Discussions to connect around esp-jsondb — a lightweight, MongoDB‑inspired document database for ESP32. Join in to:

• Ask questions: how‑tos, API usage, performance.
• Share ideas: features, integrations, naming, and UX.
• Show builds: projects and sketches using esp-jsondb.
• Collaborate: schema patterns, debugging, filesystem tips.
• Welcome others: be kind, constructive, and curious — we build this together 💪

To get started, reply below with a quick intro and how you plan to use esp-jsondb.

What To Use Where

• Discussions: questions, ideas, help, examples, architecture chats.
• Issues: reproducible bugs and focused feature requests.

Helpful Topics

• Collections and documents: queries, updates, bulk ops.
• Schema validation: field types, custom validators, defaults.
• References: patterns and populate tips.
• Storage and sync: autosync intervals, LittleFS layout, flash wear.
• Performance: RAM/PSRAM sizing, batch inserts, no‑op updates.
• Timestamps: ensuring system time for createdAt/updatedAt.

Before You Ask

Include details so folks can help quickly:

• Board/SDK: ESP32 model, Arduino or ESP‑IDF version.
• Library versions: ArduinoJson, LittleFS, ArduinoStreamUtils.
• Build env: PlatformIO/Arduino IDE versions + toolchain.
• Storage setup: baseDir, filesystem mount, autosync interval.
• Repro steps: minimal sketch, expected vs actual behavior.
• Logs/diagnostics: db.onError(...) messages, db.getDiag() output.

Quick Links

• README: setup, examples, and APIs — README.md
• Examples: ready‑to‑run sketches — examples
• Contributing guide: how to propose changes — CONTRIBUTING.md
• License: usage terms — LICENSE.md

Tips and Best Practices

• Normalize paths: baseDir is sanitized to start with / (e.g. "db" → "/db").
• Time sync: call configTime(...) before creating/updating for correct timestamps.
• Avoid unnecessary writes: no‑op updates do not mark docs dirty or bump timestamps.
• Bulk operations: use createMany, updateMany, findMany for batches.
• Schemas: validate incoming documents and set safe defaults.

Contributing via Discussions

• Propose ideas: describe the problem, constraints, and desired API/UX.
• Share designs: small sketches or pseudocode help a lot.
• Vote and react: add 👍 to threads you care about to help prioritize.

Thanks for being here — excited to see what you build with esp-jsondb!