Skip to content

Conversation

@ChristianBirke
Copy link

Summary

This PR adds two improvements to the project:

  1. macOS system files in .gitignore: Prevents .DS_Store, .AppleDouble, and .LSOverride from being tracked
  2. Comprehensive CLAUDE.md documentation: Detailed guide for Claude Code covering:
    • Essential setup commands and secret generation
    • Service startup sequences and platform-specific instructions
    • Critical architecture details (two-phase startup, SearXNG handling)
    • Service integration patterns (n8n, Flowise, Open WebUI)
    • Comprehensive troubleshooting guide
    • Development workflows and repository structure

Changes

  • Updated .gitignore to exclude macOS system files
  • Added CLAUDE.md (300 lines) for AI-assisted development

🤖 Generated with Claude Code

coleam00 and others added 10 commits June 8, 2025 09:00
* Remove all port mappings between the host machine and the containers

* Add expose elements for informative purposes

* Add concept of environment and reset Supabase ports in public environment

* Remove network_mode host from Caddy service

* Open ports on localhost, when in private environment

* Update README.md to include explanation of environment argument

* Comment out endpoints without authentication in Caddyfile

* Fix Caddy configuration to use container names and not localhost

* Update README.md

Added "-b stable" as this is now the release state

* Updating .env.example to go along with Supabase .env changes

* Note in README for deploying to VPS without Docker Compose

---------

Co-authored-by: Benny Tops <[email protected]>
Co-authored-by: Leex <[email protected]>
- **Files not Found in Supabase Folder** to troubleshooting section
# Pool size for internal metadata storage used by Supavisor
# This is separate from client connections and used only by Supavisor itself
POOLER_DB_POOL_SIZE=5
Added .DS_Store, .AppleDouble, and .LSOverride to prevent macOS
system files from being tracked in the repository.

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

Co-Authored-By: Claude <[email protected]>
Created detailed guide for Claude Code covering:
- Essential setup commands and secret generation
- Service startup sequences and platform-specific instructions
- Critical architecture details (two-phase startup, SearXNG handling)
- Service integration patterns (n8n, Flowise, Open WebUI)
- Comprehensive troubleshooting guide
- Development workflows and repository structure

This provides future Claude Code instances with the architectural
context needed to work effectively with this multi-service
Docker Compose orchestration.

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

Co-Authored-By: Claude <[email protected]>
Brings in improvements from stable branch:
- Add macOS system files to .gitignore (.DS_Store, .AppleDouble, .LSOverride)
- Add comprehensive CLAUDE.md documentation for Claude Code

Merge strategy: Kept main's versions of core infrastructure files
(.env.example, README.md, docker-compose.yml, start_services.py)
as they are more up-to-date.

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

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants