---
title: "Preview Notice"
description: "Current status, API stability, and what to expect from RoomSharp"
canonical: "https://roomsharp.dev/docs/v0.4.7/preview-notice"
source: "src/content/v0.4.7/preview-notice.mdx"
---

# Preview Notice

<Callout type="warning" title="RoomSharp is Currently in Preview">
Thank you for your interest in RoomSharp! The framework is currently in a **Preview Release** stage. Here's what you need to know.
</Callout>

---

## What Does Preview Mean?

RoomSharp is fully functional and production-ready from a code perspective. The NuGet packages are public and can be used in real projects. However, the source code repository is not yet publicly available.

---

## API Stability Notice

RoomSharp is still under active development.

While the core concepts and architecture are stable, **public APIs may change** as the project evolves, especially before the first stable (1.0) release.

Breaking changes will be documented clearly in release notes and migration guidance will be provided where possible.

---

## What's Available Now

- ✅ **NuGet Packages:** All packages are published and production-ready
- ✅ **CLI Tool:** Full scaffolding, migrations, and inspection commands
- ✅ **Documentation:** Complete API documentation and guides
- ✅ **Benchmarks:** Performance metrics and comparisons with Dapper
- ✅ **Multi-Provider Support:** SQLite, SQL Server, PostgreSQL, MySQL

---

## Official NuGet Packages

| Package | Description |
|---------|-------------|
| [RoomSharp](https://www.nuget.org/packages/RoomSharp) | Core package with SQLite support |
| [RoomSharp.SqlServer](https://www.nuget.org/packages/RoomSharp.SqlServer) | SQL Server provider |
| [RoomSharp.PostgreSql](https://www.nuget.org/packages/RoomSharp.PostgreSql) | PostgreSQL provider |
| [RoomSharp.MySql](https://www.nuget.org/packages/RoomSharp.MySql) | MySQL/MariaDB provider |
| [RoomSharp.DependencyInjection](https://www.nuget.org/packages/RoomSharp.DependencyInjection) | DI extensions |
| [RoomSharp.QueryExtensions](https://www.nuget.org/packages/RoomSharp.QueryExtensions) | Dapper-like raw SQL API |
| [RoomSharp.Cli](https://www.nuget.org/packages/RoomSharp.Cli) | CLI tool for scaffolding & migrations |

---

## What's Coming After Preview

Once the Preview stage is complete:

- 📦 **Open Source Repository:** Full source code on GitHub
- 🐛 **Public Issue Tracking:** GitHub Issues for bug reports and feature requests
- 🤝 **Community Contributions:** Pull requests welcome
- 📚 **Extended Samples:** More example projects and templates

---

## Can I Use RoomSharp in Production?

<Callout type="tip" title="Yes!">
The packages are stable and production-ready. The Preview status only relates to the source code visibility, not the quality or stability of the framework.
</Callout>

---

## Design Philosophy

RoomSharp deliberately avoids feature creep.

New capabilities are added only when they align with its explicit, predictable design philosophy:

- **Compile-time code generation** instead of runtime reflection
- **Explicit, predictable behavior** over magic
- **Multi-provider support** with provider-specific optimizations
- **Performance-first** with zero-allocation hot paths

---

## Staying Updated

To stay informed about RoomSharp's progress:

- Watch the [NuGet package](https://www.nuget.org/packages/RoomSharp) for updates
- Check this documentation site regularly
- Follow the [Roadmap](/docs/v0.4.7/roadmap) for planned features
- Read [Release Notes](/docs/v0.4.7/release-notes-0-4-3) for version details

---

## License

MIT