overhaul

internal/build/README.md

@@ -0,0 +1,67 @@
+# Railpack Integration
+
+This directory contains the build system for Containr, with Railpack as the primary build method.
+
+## Build Types
+
+### Railpack (Primary)
+- **Detection**: Automatically detects supported frameworks (Node.js, Python, Go, Rust, Java, Ruby, PHP, Static)
+- **API**: Uses https://api.railpack.app/v1/ for Dockerfile generation
+- **Fallback**: Falls back to Nixpacks if Railpack cannot build the project
+
+### Nixpacks (Secondary)
+- **Detection**: Used as fallback when Railpack detection fails
+- **Local**: Runs locally without external API calls
+
+### Dockerfile
+- **Detection**: Checks for existing Dockerfile in repository
+- **Priority**: Highest priority if Dockerfile exists
+
+### Prebuilt
+- **Usage**: For pre-built container images
+- **Configuration**: Specified in service configuration
+
+## Supported Frameworks
+
+Railpack supports the following frameworks:
+- **Node.js** - package.json detection
+- **Python** - requirements.txt detection  
+- **Go** - go.mod detection
+- **Rust** - Cargo.toml detection
+- **Java** - pom.xml or build.gradle detection
+- **Ruby** - Gemfile detection
+- **PHP** - composer.json detection
+- **Static** - Static site detection
+
+## Usage
+
+```go
+// Create build manager
+buildManager := build.NewBuildManager("/tmp/builds", dockerClient)
+
+// Build a project
+response, err := buildManager.Build(ctx, &types.BuildRequest{
+    SourcePath: "/path/to/project",
+    ImageName:  "my-app",
+    ImageTag:   "latest",
+})
+```
+
+## API Endpoints
+
+- **Generate Dockerfile**: POST https://api.railpack.app/v1/generate
+- **Build Plan**: POST https://api.railpack.app/v1/plan
+
+## Configuration
+
+Railpack can be configured with:
+- Custom build commands
+- Custom start commands  
+- Environment variables
+- Build root directory
+
+## References
+
+- https://railpack.com/
+- https://railpack.com/getting-started
+- https://github.com/railwayapp/railpack