{"id":32663917,"url":"https://github.com/ravendb/samples-library","last_synced_at":"2026-05-06T06:37:45.042Z","repository":{"id":321764005,"uuid":"1086581832","full_name":"ravendb/samples-library","owner":"ravendb","description":"A simple library system showing various capabilities of RavenDB","archived":false,"fork":false,"pushed_at":"2025-10-31T11:11:11.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-31T12:18:18.127Z","etag":null,"topics":["aspire","azure","azure-functions","database","dotnet","ravendb"],"latest_commit_sha":null,"homepage":"https://library.samples.ravendb.net","language":"C#","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/ravendb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2025-10-30T16:02:22.000Z","updated_at":"2025-10-31T11:11:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ravendb/samples-library","commit_stats":null,"previous_names":["ravendb/samples-library"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ravendb/samples-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravendb%2Fsamples-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravendb%2Fsamples-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravendb%2Fsamples-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravendb%2Fsamples-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ravendb","download_url":"https://codeload.github.com/ravendb/samples-library/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravendb%2Fsamples-library/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282070789,"owners_count":26608933,"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","status":"online","status_checked_at":"2025-10-31T02:00:07.401Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["aspire","azure","azure-functions","database","dotnet","ravendb"],"created_at":"2025-10-31T23:00:57.331Z","updated_at":"2026-05-06T06:37:45.036Z","avatar_url":"https://github.com/ravendb.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Library of Ravens\n\n[![Build](https://github.com/ravendb/samples-library/actions/workflows/build.yml/badge.svg)](https://github.com/ravendb/samples-library/actions/workflows/build.yml)\n\n## Overview\n\nThe Library of Ravens **solves the \"architecture bloat\"** of managing separate databases by **consolidating full-text and vector search into a single database**. Instead of wrestling with data synchronization across multiple platforms, you get a unified search experience that keeps your infrastructure lean and your development cycle fast.\n\nThe app demonstrates **robust integration patterns using Azure Storage Queues**. By leveraging RavenDB’s change tracking and ETL services, the system ensures that critical library updates are never lost, providing architectural resilience.\n\nFinally, the app **addresses the \"cloud tax\" of high egress fees** by utilizing ETags and native HTTP caching driven by RavenDB’s metadata. This approach significantly reduces the volume of data sent over the wire, slashing public cloud billing while providing a snappier, more responsive experience for the end user through efficient data reuse.\n\nBuilt with [RavenDB](https://ravendb.net), [Aspire](https://aspire.dev), [Azure Storage Queues](azure.microsoft.com/en-us/products/storage/queues), and [Azure Functions](https://azure.microsoft.com/en-us/products/functions).\n\n\u003cimg width=\"2019\" height=\"1606\" alt=\"image\" src=\"https://github.com/user-attachments/assets/13e86383-c7f6-4e0e-bb55-2966d51dea9e\" /\u003e\n\n## Features used\n\nThe following RavenDB features are used to build the application:\n\n1. [Include](https://docs.ravendb.net/7.1/client-api/session/loading-entities#load-with-includes) - loading related documents in one request\n1. [Document Refresh](https://docs.ravendb.net/7.1/studio/database/settings/document-refresh) - used for timeouts handling\n1. [Azure Storage Queues ETL](https://docs.ravendb.net/7.1/server/ongoing-tasks/etl/queue-etl/azure-queue) - used with the `@Refresh` feature to send information about expiring timeouts\n1. [Vector Search](https://docs.ravendb.net/7.1/ai-integration/vector-search/ravendb-as-vector-database) - used for searching across similar books\n\n## Technologies\n\nThe following technologies were used to build this application:\n\n1. [RavenDB](https://ravendb.net/)\n1. [.NET 10](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)\n1. [Aspire](https://aspire.dev/)\n1. [Azure Functions](https://azure.microsoft.com/en-us/products/functions)\n1. [Azure Storage Queues](https://azure.microsoft.com/products/storage/queues)\n1. [SvelteKit](https://svelte.dev/)\n\n## Run locally\n\nIf you want to run the application locally, please follow the steps:\n\n1. Check out the GIT repository\n1. Install prerequisites:\n   1. [.NET 10](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)\n   1. [Aspire.dev](https://aspire.dev/get-started/install-cli/)\n   2. [nodejs](https://nodejs.org)\n1. Request a [dev license](https://ravendb.net/license/request/dev-ai-agent-inside) and set it under `RAVEN_LICENSE` env variable\n1. Get the app running by opening `/src/RavenDB.Samples.Library.sln` and starting the `Aspire` `AppHost` project\n\n## Community \u0026 Support\n\nIf you spot a bug, have an idea or a question, please let us know by raising an issue or creating a pull request. \n\nWe do use a [Discord server](https://discord.gg/ravendb). If you have any doubts, don't hesitate to reach out!\n\n## Contributing\n\nWe encourage you to contribute! Please read our [CONTRIBUTING](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## License\n\nThis project is licensed with the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravendb%2Fsamples-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fravendb%2Fsamples-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravendb%2Fsamples-library/lists"}