Skip to content

CLAUDE.md

Latest commit

 

History

History
76 lines (58 loc) · 2.58 KB

CLAUDE.md

File metadata and controls

76 lines (58 loc) · 2.58 KB

Memorizer Project Guidelines

GitHub Workflow

  • Always create pull requests against petabridge/memorizer, not any fork
  • Use gh pr create --repo petabridge/memorizer when creating PRs

NuGet Package Management

This project uses Central Package Management (CPM) via Directory.Packages.props.

  • Never use VersionOverride attributes in .csproj files
  • All package versions must be defined in Directory.Packages.props
  • When adding new packages, add the <PackageVersion> entry to Directory.Packages.props first
  • Project files should only contain <PackageReference Include="PackageName" /> without version attributes

UI Styling and Theme Support

This project supports both light and dark themes. When making CSS or stylesheet changes:

  • Always provide both light and dark mode styles for any custom CSS
  • The theme is controlled via data-theme attribute on <html> element (data-theme="dark" or data-theme="light")
  • Use [data-theme="dark"] CSS selector to target dark mode styles
  • Theme switching is handled by wwwroot/js/theme-switcher.js
  • Ensure sufficient color contrast in both modes for accessibility
  • Example pattern: 
    /* Light mode (default) */
.my-class { background-color: #d4edda; color: #155724; }

/* Dark mode */
[data-theme="dark"] .my-class { background-color: #1e4620; color: #75d47b; }

Integration Test Patterns

Integration tests use shared PostgreSQL containers via XUnit test collections. Each test class creates its own ServiceProvider with a connection pool. To prevent connection exhaustion:

  • Test classes that create ServiceProvider must implement IDisposable and dispose it
  • If ServiceProvider is created in the constructor, add a Dispose() method
  • If ServiceProvider is created per-test, use using var services = CreateServices();

Example patterns:

// Pattern 1: ServiceProvider created in constructor
[Collection(nameof(IntegrationTestCollection))]
public class MyTests : IDisposable
{
    private readonly IServiceProvider _services;

    public MyTests(IntegrationTestFixture fixture)
    {
        _services = CreateServices(fixture);
    }

    public void Dispose()
    {
        (_services as IDisposable)?.Dispose();
    }
}

// Pattern 2: ServiceProvider created per-test (for different configurations)
[Collection(nameof(IntegrationTestCollection))]
public class MyTests
{
    private ServiceProvider CreateServices(string model) { /* ... */ }

    [Fact]
    public async Task MyTest()
    {
        using var services = CreateServices("model-a");
        // test code...
    }
}