{"id":45073644,"url":"https://github.com/microbit-foundation/capacitor-sqlite-vanilla","last_synced_at":"2026-02-24T18:01:12.288Z","repository":{"id":339163276,"uuid":"1160700939","full_name":"microbit-foundation/capacitor-sqlite-vanilla","owner":"microbit-foundation","description":"Capacitor SQLite plugin that uses iOS platform sqlite and Android's androidx's sqlite-bundled","archived":false,"fork":false,"pushed_at":"2026-02-19T11:14:39.000Z","size":134,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-20T16:12:17.460Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microbit-foundation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-18T09:12:49.000Z","updated_at":"2026-02-19T11:14:01.000Z","dependencies_parsed_at":"2026-02-20T14:02:25.222Z","dependency_job_id":null,"html_url":"https://github.com/microbit-foundation/capacitor-sqlite-vanilla","commit_stats":null,"previous_names":["microbit-foundation/capacitor-sqlite-vanilla"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/microbit-foundation/capacitor-sqlite-vanilla","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbit-foundation%2Fcapacitor-sqlite-vanilla","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbit-foundation%2Fcapacitor-sqlite-vanilla/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbit-foundation%2Fcapacitor-sqlite-vanilla/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbit-foundation%2Fcapacitor-sqlite-vanilla/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microbit-foundation","download_url":"https://codeload.github.com/microbit-foundation/capacitor-sqlite-vanilla/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbit-foundation%2Fcapacitor-sqlite-vanilla/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29684060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T14:31:22.911Z","status":"ssl_error","status_checked_at":"2026-02-21T14:31:22.570Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-19T13:03:31.552Z","updated_at":"2026-02-21T15:01:17.233Z","avatar_url":"https://github.com/microbit-foundation.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @microbit/capacitor-sqlite-vanilla\n\nMinimal Capacitor 7 plugin for SQLite on iOS and Android.\n\nNo encryption (no crypto export drama). No web support.\n\n**Stumbled across this?** This plugin has intentionally limited scope and has\nhad no real world use outside of one app. Your goals might be better met via\nhttps://github.com/capacitor-community/sqlite or perhaps\nhttps://capawesome.io/plugins/sqlite/ (commercial).\n\n## Supported versions\n\n### Android\n\nUses `androidx.sqlite:sqlite-bundled` which embeds SQLite compiled from source,\nproviding a consistent and up-to-date version regardless of the device's OS. This\navoids the fragmentation of Android's system SQLite.\n\n### iOS\n\nUses the system `sqlite3` framework. The SQLite version depends on the user's OS\nversion — the minimum is **SQLite 3.32.3** (iOS 14, the lowest version supported\nby Capacitor 7). Notable features unavailable on older iOS versions include:\n\n- `RETURNING` clause and `ALTER TABLE DROP COLUMN` (3.35.0, iOS 15+)\n- `STRICT` tables (3.37.0, iOS 15.4+)\n- Built-in JSON operators `-\u003e` / `-\u003e\u003e` (3.38.0, iOS 16+)\n- `RIGHT` and `FULL OUTER JOIN` (3.39.0, iOS 16+)\n\n### BLOB handling\n\nBLOB columns in query results are returned as arrays of unsigned byte values (0–255),\ne.g. `[72, 101, 108, 108, 111]`. This matches the behaviour of the Capacitor community\nSQLite plugin but is inefficient for large values — consider storing binary data as\nbase64-encoded TEXT instead.\n\n## API\n\n### Bridge methods\n\n| Method                                  | Description                                        |\n| --------------------------------------- | -------------------------------------------------- |\n| `open({name})`                          | Open or create a database                          |\n| `close({name})`                         | Close a database                                   |\n| `execute({name, statements})`           | Execute raw SQL (DDL, multi-statement)             |\n| `run({name, statement, values?})`       | Parameterized write, returns `{changes, lastId}`   |\n| `query({name, statement, values?})`     | Parameterized read, returns `{values: [...]}`      |\n| `executeSet({name, set, transaction?})` | Multiple parameterized statements in a transaction |\n| `isDBOpen({name})`                      | Check if a database is open                        |\n| `deleteDatabase({name})`                | Delete a database file                             |\n| `getVersion({name})`                    | Get SQLite `user_version` pragma                   |\n\n### TypeScript wrappers\n\n`SQLiteConnection` and `SQLiteDBConnection` provide a convenience API over the bridge:\n\n```typescript\nimport { SQLiteVanilla, SQLiteConnection } from '@microbit/capacitor-sqlite-vanilla';\n\nconst db = await sqlite.createConnection('my-db');\n\nawait db.execute('CREATE TABLE IF NOT EXISTS items (id TEXT PRIMARY KEY, name TEXT)');\nawait db.run('INSERT INTO items (id, name) VALUES (?, ?)', ['1', 'Example']);\nconst { values } = await db.query('SELECT id, name FROM items');\nawait db.close();\n```\n\n## Build\n\n```\nnpm install\nnpm run build\n```\n\n## License\n\nThis software is under the MIT open source license.\n\n[SPDX-License-Identifier: MIT](LICENSE)\n\nWe use dependencies via the NPM registry as specified by the package.json file under common Open Source licenses.\n\nFull details of each package can be found by running `license-checker`:\n\n```bash\n$ npx license-checker --direct --summary --production\n```\n\nOmit the flags as desired to obtain more detail.\n\n## Code of conduct\n\nTrust, partnership, simplicity and passion are our core values we live and\nbreathe in our daily work life and within our projects. Our open-source\nprojects are no exception. We have an active community which spans the globe\nand we welcome and encourage participation and contributions to our projects\nby everyone. We work to foster a positive, open, inclusive and supportive\nenvironment and trust that our community respects the micro:bit code of\nconduct. Please see our [code of conduct](https://microbit.org/safeguarding/)\nwhich outlines our expectations for all those that participate in our\ncommunity and details on how to report any concerns and what would happen\nshould breaches occur.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrobit-foundation%2Fcapacitor-sqlite-vanilla","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrobit-foundation%2Fcapacitor-sqlite-vanilla","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrobit-foundation%2Fcapacitor-sqlite-vanilla/lists"}