{"id":27862583,"url":"https://github.com/a360n/firebasefirestoreswiftmanual","last_synced_at":"2026-04-29T13:35:21.344Z","repository":{"id":290484102,"uuid":"974608648","full_name":"a360n/FirebaseFirestoreSwiftManual","owner":"a360n","description":"FirebaseFirestoreSwiftManual provides a minimal alternative to FirebaseFirestoreSwift, enabling apps to easily decode and encode Firestore documents in Swift using property wrappers like @DocumentID and @ServerTimestamp.  It's ideal for projects that face issues integrating FirebaseFirestoreSwift via SPM or need a lightweight manual replacement.   ","archived":false,"fork":false,"pushed_at":"2025-04-29T03:45:05.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-29T04:34:48.217Z","etag":null,"topics":["codable","documentid","firebase","firebase-firestore","firebase-ios","firestore","servertimestamp","swift","swiftpm"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a360n.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}},"created_at":"2025-04-29T03:26:05.000Z","updated_at":"2025-04-29T03:45:08.000Z","dependencies_parsed_at":"2025-04-29T04:34:49.847Z","dependency_job_id":"a044539e-8a6b-453f-ba83-f8a90004551c","html_url":"https://github.com/a360n/FirebaseFirestoreSwiftManual","commit_stats":null,"previous_names":["a360n/firebasefirestoreswiftmanual"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a360n%2FFirebaseFirestoreSwiftManual","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a360n%2FFirebaseFirestoreSwiftManual/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a360n%2FFirebaseFirestoreSwiftManual/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a360n%2FFirebaseFirestoreSwiftManual/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a360n","download_url":"https://codeload.github.com/a360n/FirebaseFirestoreSwiftManual/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252395622,"owners_count":21741068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["codable","documentid","firebase","firebase-firestore","firebase-ios","firestore","servertimestamp","swift","swiftpm"],"created_at":"2025-05-04T20:31:16.258Z","updated_at":"2026-04-29T13:35:21.306Z","avatar_url":"https://github.com/a360n.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FirebaseFirestoreSwiftManual\n\nA lightweight manual alternative to `FirebaseFirestoreSwift` that enables Swift Codable support for Firestore `@DocumentID` and `@ServerTimestamp`.\n\nThis package is designed to be used when `FirebaseFirestoreSwift` is not available through Swift Package Manager (SPM) or you need a minimal manual replacement.\n\n---\n\n## Why This Exists\nGoogle's official Firebase iOS SDK includes `FirebaseFirestoreSwift`, but it is sometimes:\n- Unavailable through SPM (Swift Package Manager).\n- Delayed in updates compared to CocoaPods integration.\n- Bundled with heavier dependencies you might not need.\n\nThis project extracts and adapts the necessary functionality to enable:\n- `@DocumentID`\n- `@ServerTimestamp`\n\nwithout requiring the full `FirebaseFirestoreSwift` module.\n\n---\n\n## What's Included\n\n| File | Purpose |\n|:---|:---|\n| `DocumentID.swift` | Property wrapper for Firestore Document ID mapping |\n| `ServerTimestamp.swift` | Property wrapper for automatic server timestamp mapping |\n\n---\n\n## Installation\n\nSince this is a manual integration, simply:\n\n1. Download or clone this repository.\n2. Copy the `Sources/` folder into your Xcode project.\n3. Make sure your project already imports:\n   - `FirebaseFirestore`\n   - `FirebaseCore`\n\n---\n\n## Usage\n\n### Using `@DocumentID`\n```swift\nstruct User: Codable, Identifiable {\n    @DocumentID var id: String?\n    var email: String\n    var username: String\n}\n```\nWhen you retrieve a document from Firestore, the `id` will be automatically filled with the document's ID.\n\n### Using `@ServerTimestamp`\n```swift\nstruct Message: Codable {\n    @ServerTimestamp var createdAt: Timestamp?\n    var text: String\n}\n```\nWhen you write a `Message` with `createdAt = nil`, Firestore will automatically fill it with the server's current time.\n\n---\n\n## Requirements\n\n- iOS 14+\n- Swift 5.7+\n- Firebase iOS SDK 10.0.0+\n\n---\n\n## Important Notes\n- This package manually replicates parts of the official `FirebaseFirestoreSwift`.\n- You should update manually if Google makes major changes to Firestore Codable behavior.\n- Not officially maintained by Google or Firebase team.\n\n---\n\n## License\nThis project is licensed under the Apache License 2.0.\n\nYou are free to use, modify, and distribute this project under the terms of the Apache 2.0 License.\n\n\n---\n\n## Contributions\n\nFeel free to fork and enhance!\n\n- Add support for more property wrappers if needed.\n- Improve Codable compliance.\n- Extend documentation.\n\n---\n\nCreated  by Ali Nasser for the SecureChat Project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa360n%2Ffirebasefirestoreswiftmanual","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa360n%2Ffirebasefirestoreswiftmanual","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa360n%2Ffirebasefirestoreswiftmanual/lists"}