docs: rewrite README with professional format

- Concise structure with tables for features and status
- Updated quick start example with PostgreSQL 15 requirement
- Added installation section with dev-dependencies
- Removed emojis and unnecessary content

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: j7nw4r

README.md

@@ -1,58 +1,35 @@
-# Supabase-Testcontainers
+# supabase-testcontainers-modules
 
-> ⚠️ **Development Status**: This crate is currently under active development and is not yet ready for production use. APIs may change significantly between versions.
+Testcontainers modules for Supabase services in Rust. Run real Supabase containers in your integration tests.
 
-A Rust implementation of [Testcontainers](https://github.com/testcontainers/testcontainers-rs) for [Supabase](https://supabase.com/) services. This crate provides utilities for setting up and managing Supabase services in a containerized environment, primarily for testing purposes.
+> **Note**: This crate is under active development. APIs may change between versions.
 
 ## Installation
 
-Add this to your `Cargo.toml`:
-
-```toml
-[dependencies]
-supabase-testcontainers-modules = "0.1.0"
-```
-
-Or with specific features:
-
 ```toml
 [dependencies]
 supabase-testcontainers-modules = { version = "0.1.0", features = ["auth"] }
-```
-
-## Features
 
-- `analytics` - Enables the Supabase Analytics service container support
-- `auth` - Enables the Supabase Auth service container support
-- `const` - Provides constant values used throughout the crate
-- `error` - Enables error handling functionality
-- `functions` - Enables the Edge Functions service container support
-- `graphql` - Enables the GraphQL (pg_graphql) service container support
-- `postgrest` - Enables the PostgREST service container support
-- `postgres_testcontainer` - Enables PostgreSQL container support
-- `realtime` - Enables the Realtime service container support
-- `storage` - Enables the Storage service container support
-
-## Usage
-
-### Auth with PostgreSQL
+[dev-dependencies]
+testcontainers = "0.23"
+testcontainers-modules = { version = "0.11", features = ["postgres"] }
+tokio = { version = "1", features = ["full"] }
+```
 
-The Auth service requires PostgreSQL. Here's a complete example:
+## Quick Start
 
 ```rust
 use supabase_testcontainers_modules::{Auth, AUTH_PORT, DOCKER_INTERNAL_HOST, LOCAL_HOST};
-use testcontainers::runners::AsyncRunner;
+use testcontainers::{runners::AsyncRunner, ImageExt};
 use testcontainers_modules::postgres::Postgres;
 
-#[tokio::main]
-async fn main() -> anyhow::Result<()> {
-    // 1. Start PostgreSQL container
-    let postgres = Postgres::default().start().await?;
+#[tokio::test]
+async fn test_auth() -> anyhow::Result<()> {
+    // Start PostgreSQL (requires version 12+)
+    let postgres = Postgres::default().with_tag("15-alpine").start().await?;
     let pg_port = postgres.get_host_port_ipv4(5432).await?;
 
-    // 2. Build connection strings
-    // - Auth container connects via docker internal host
-    // - Schema init connects via localhost (from host machine)
+    // Connection strings
     let auth_db_url = format!(
         "postgres://supabase_auth_admin:password@{}:{}/postgres",
         DOCKER_INTERNAL_HOST, pg_port
@@ -62,62 +39,70 @@ async fn main() -> anyhow::Result<()> {
         LOCAL_HOST, pg_port
     );
 
-    // 3. Initialize database schema and start Auth
+    // Start Auth container
     let auth = Auth::default()
         .with_db_url(&auth_db_url)
-        .with_anonymous_users(true)
         .init_db_schema(&local_db_url, "password")
         .await?
         .start()
         .await?;
 
     let auth_port = auth.get_host_port_ipv4(AUTH_PORT).await?;
-    println!("Auth API available at http://localhost:{}", auth_port);
 
-    // 4. Make requests to the Auth API
-    let health = reqwest::get(format!("http://localhost:{}/health", auth_port))
-        .await?;
-    assert_eq!(health.status(), 200);
+    // Verify health
+    let resp = reqwest::get(format!("http://localhost:{}/health", auth_port)).await?;
+    assert_eq!(resp.status(), 200);
 
     Ok(())
 }
 ```
 
-### Configuration Options
+## Auth Configuration
 
 ```rust
-use supabase_testcontainers_modules::Auth;
-
-let auth = Auth::default()
-    .with_db_url("postgres://...")           // PostgreSQL connection
-    .with_jwt_secret("32-char-secret...")    // JWT signing secret
+Auth::default()
+    .with_db_url("postgres://...")           // PostgreSQL connection (required)
+    .with_jwt_secret("32-char-minimum...")   // JWT signing secret
     .with_jwt_expiry(3600)                   // Token expiry in seconds
     .with_site_url("http://localhost:3000")  // Frontend URL
-    .with_signup_disabled(false)             // Allow signups
+    .with_signup_disabled(false)             // Allow user signups
     .with_anonymous_users(true)              // Enable anonymous auth
-    .with_mailer_autoconfirm(true)           // Auto-confirm emails (testing)
-    .with_sms_autoconfirm(true)              // Auto-confirm SMS (testing)
+    .with_mailer_autoconfirm(true)           // Skip email verification
+    .with_sms_autoconfirm(true)              // Skip SMS verification
     .with_log_level("debug")                 // Log verbosity
-    .with_tag("v2.183.0")                    // Custom image version
-    .with_env("CUSTOM_VAR", "value");        // Custom env var
+    .with_tag("v2.183.0")                    // Image version
+    .with_env("KEY", "value")                // Custom environment variable
 ```
 
-## Current Status
-
-The following Supabase services are implemented or planned:
-
-- [ ] Analytics
-- [x] Auth (fully implemented)
-- [ ] Edge Functions
-- [ ] GraphQL (pg_graphql)
-- [x] PostgREST (basic implementation)
-- [ ] Realtime
-- [x] Storage (basic implementation)
-
-## Contributing
+## Features
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+| Feature | Description |
+|---------|-------------|
+| `auth` | Supabase Auth (GoTrue) container |
+| `postgrest` | PostgREST container |
+| `storage` | Supabase Storage container |
+| `realtime` | Realtime container |
+| `functions` | Edge Functions container |
+| `graphql` | pg_graphql container |
+| `analytics` | Analytics container |
+
+## Requirements
+
+- Docker
+- PostgreSQL 12+ (for Auth migrations)
+
+## Implementation Status
+
+| Service | Status |
+|---------|--------|
+| Auth | Complete |
+| PostgREST | Basic |
+| Storage | Basic |
+| Realtime | Planned |
+| Functions | Planned |
+| GraphQL | Planned |
+| Analytics | Planned |
 
 ## License
 
-This project is licensed under the MIT License.
+MIT