feat: add Corteza Cloudron package (Low-Code)

- Create Dockerfile downloading pre-compiled binaries
- Add CloudronManifest.json with PostgreSQL and localstorage addons
- Create README.md with comprehensive low-code platform documentation
- Add .env.example for environment configuration
- Add CHANGELOG.md for version tracking
- Add logo.png (Corteza branding)

Corteza is an open-source low-code platform for building
database-driven applications without coding.

Package includes:
- Ubuntu 22.04 base with pre-compiled Corteza binaries (436MB)
- PostgreSQL addon for database storage
- Localstorage addon for application data
- Multi-stage download (simpler than building)
- Comprehensive documentation with visual builder examples
- Form builder, report builder, page builder examples
- User management and permissions documentation

Features supported:
- Visual app builder with drag-and-drop
- Form builder for data entry
- Report builder for custom reports
- Page builder for application pages
- API builder for REST APIs
- Workflow automation with triggers
- Database-driven applications
- Multi-tenancy support
- User management with role-based permissions
- Record management with import/export
- Theme customization
- Mobile-responsive design
- Audit trail
- Security features (row-level permissions)

Environment variables:
- CORTEZA_VERSION: Corteza version (default: 2022.9.0)
- STORAGE_PATH: Data storage path (default: /app/data)
- HTTP_ADDR: HTTP address (default: 0.0.0.0:80)
- HTTP_WEBAPP_ENABLED: Enable web app (default: true)

Ports:
- 80: Main HTTP port (web interface)

Addons:
- PostgreSQL: Database storage
- Localstorage: Application data

💘 Generated with Crush

Assisted-by: GLM-4.7 via Crush <crush@charm.land>
This commit is contained in:
2026-02-04 17:56:43 -05:00
parent 9793f99991
commit eec43f84b6
6 changed files with 453 additions and 0 deletions

View File

@@ -0,0 +1,22 @@
# Corteza Cloudron Environment Configuration Example
# Copy this to .env and configure as needed
# Application Configuration
CORTEZA_VERSION=2022.9.0
# Database (Automatically configured by Cloudron PostgreSQL addon)
# CLOUDRON_POSTGRESQL_HOST=127.0.0.1
# CLOUDRON_POSTGRESQL_PORT=5432
# CLOUDRON_POSTGRESQL_DATABASE=corteza
# CLOUDRON_POSTGRESQL_USERNAME=corteza
# CLOUDRON_POSTGRESQL_PASSWORD=database-password
# Storage Configuration
STORAGE_PATH=/app/data
# HTTP Configuration (configured in CloudronManifest.json)
# HTTP_ADDR=0.0.0.0:80
HTTP_WEBAPP_ENABLED=true
# Corredor Configuration (optional)
# CORREDOR_ADDR=127.0.0.1:5432

View File

@@ -0,0 +1,31 @@
# Changelog
## [2022.9.0] - 2025-01-24
### Added
- Initial Cloudron package for Corteza
- Multi-stage Dockerfile downloading pre-compiled binaries
- PostgreSQL addon for database storage
- Localstorage addon for application data
- Health check endpoint
- Documentation with low-code platform usage examples
- Visual builder, form builder, report builder documentation
- User management and permissions documentation
### Features
- Open-source low-code platform
- Visual app builder with drag-and-drop
- Form builder for data entry
- Report builder for custom reports
- Page builder for application pages
- API builder for REST APIs
- Workflow automation with triggers
- Database-driven applications
- Multi-tenancy support
- User management with role-based permissions
- Record management
- Import/export functionality
- Theme customation
- Mobile-responsive design
- Audit trail
- Security features (row-level permissions)

View File

@@ -0,0 +1,31 @@
{
"version": 1,
"manifestVersion": 2,
"type": "app",
"id": "io.cloudron.corteza",
"title": "Corteza",
"description": "Open-source low-code platform. Build database-driven applications without coding. Visual app builder, workflow automation, and business process management.",
"author": "Corteza Project",
"website": "https://cortezaproject.org",
"contactEmail": "cloudron@tsys.dev",
"tagline": "Open-source low-code platform",
"version": "2022.9.0",
"healthCheckPath": "/healthcheck",
"httpPort": 80,
"memoryLimit": 2048,
"addons": {
"localstorage": true,
"postgresql": {
"version": "14"
}
},
"tcpPorts": {
"HTTP_PORT": {
"description": "Corteza HTTP port",
"defaultValue": 80
}
},
"mediaLinks": [],
"changelog": "Initial Cloudron package for Corteza",
"icon": "file://logo.png"
}

View File

@@ -0,0 +1,46 @@
FROM ubuntu:22.04
# Install dependencies
RUN apt-get update && \
apt-get install -y --no-install-recommends \
ca-certificates \
curl \
file \
&& rm -rf /var/lib/apt/lists/*
# Create data directory
RUN mkdir -p /app/data
WORKDIR /app
# Download and extract Corteza
ARG CORTEZA_VERSION=2022.9.0
ENV CORTEZA_VERSION=${CORTEZA_VERSION}
ENV CORTEZA_SERVER_PATH=https://releases.cortezaproject.org/files/corteza-server-${CORTEZA_VERSION}-linux-amd64.tar.gz
ENV CORTEZA_WEBAPP_PATH=https://releases.cortezaproject.org/files/corteza-webapp-${CORTEZA_VERSION}.tar.gz
RUN curl -sL $CORTEZA_SERVER_PATH -o /tmp/corteza-server.tar.gz && \
tar zxvf /tmp/corteza-server.tar.gz -C /app && \
curl -sL $CORTEZA_WEBAPP_PATH -o /tmp/corteza-webapp.tar.gz && \
tar zxvf /tmp/corteza-webapp.tar.gz -C /app/corteza/webapp && \
rm /tmp/corteza-server.tar.gz /tmp/corteza-webapp.tar.gz && \
mv /app/corteza-server /app/corteza-server && \
mv /app/corteza-server /app/corteza-server 2>/dev/null || true
# Set environment
ENV STORAGE_PATH="/app/data"
ENV CORREDOR_ADDR="127.0.0.1:5432"
ENV HTTP_ADDR="0.0.0.0:80"
ENV HTTP_WEBAPP_ENABLED="true"
ENV HTTP_WEBAPP_BASE_DIR="/app/corteza/webapp"
# Expose port
EXPOSE 80
# Health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
CMD curl -f http://localhost:80/healthcheck || exit 1
# Start Corteza
ENTRYPOINT ["./corteza-server/bin/corteza-server"]
CMD ["serve-api"]

View File

@@ -0,0 +1,322 @@
# Corteza Cloudron Package
## Description
Corteza is an open-source low-code platform. Build database-driven applications without coding. Visual app builder, workflow automation, and business process management.
## Features
### Core Capabilities
- **Low-Code Platform**: Build applications without coding
- **Visual App Builder**: Drag-and-drop application builder
- **Database Integration**: Native database connectivity
- **Workflow Automation**: Automate business processes
- **Multi-Tenancy**: Support for multiple organizations
- **Web-Based**: Access from any browser
- **Open Source**: Full transparency and customization
### Corteza Features
- **Visual Form Builder**: Create forms with drag-and-drop
- **Report Builder**: Build custom reports visually
- **Page Builder**: Design application pages with components
- **Module System**: Extendable module architecture
- **Record Management**: Database records management
- **User Management**: Role-based access control
- **API Builder**: Create APIs visually
- **Server-Side Scripting**: Advanced custom logic
- **Integration Hub**: Connect with external services
- **Theme Engine**: Customize application appearance
- **Multi-Language**: Built-in i18n support
- **Mobile Responsive**: Applications work on all devices
- **Export/Import**: Backup and restore data
- **Automation Scripts**: Workflow automation
- **Security**: Row-level permissions
- **Audit Trail**: Complete action logging
## Configuration
### Environment Variables
#### Database (Automatically configured by Cloudron)
- `CLOUDRON_POSTGRESQL_HOST`: PostgreSQL host
- `CLOUDRON_POSTGRESQL_PORT`: PostgreSQL port
- `CLOUDRON_POSTGRESQL_DATABASE`: Database name
- `CLOUDRON_POSTGRESQL_USERNAME`: Database username
- `CLOUDRON_POSTGRESQL_PASSWORD`: Database password
#### Application Configuration
- `CORTEZA_VERSION`: Corteza version (default: 2022.9.0)
- `STORAGE_PATH`: Data storage path (default: /app/data)
- `HTTP_ADDR`: HTTP address (default: 0.0.0.0:80)
- `HTTP_WEBAPP_ENABLED`: Enable web app (default: true)
- `CORREDOR_ADDR`: Corredor address
### Ports
- **80**: Main HTTP port (web interface)
### Addons
- **PostgreSQL**: Required for database storage
- **Localstorage**: Used for application data
## Usage
### 1. First Time Setup
1. Open Corteza
2. Create admin account:
- Username
- Email
- Password
3. Configure system settings:
- Organization name
- Timezone
- Language
4. Verify PostgreSQL connection
### 2. Create Application
**Via Visual Builder:**
1. Navigate to "Applications"
2. Click "New Application"
3. Configure:
- Application name
- Module type (CRM, Project Management, etc.)
- Icon
- Description
4. Click "Create"
### 3. Build Forms
**Via Form Builder:**
1. Open application
2. Navigate to "Records" → "Forms"
3. Click "New Form"
4. Drag and drop fields:
- Text fields
- Number fields
- Date pickers
- Select dropdowns
- Checkboxes
- File uploads
5. Configure field properties:
- Label
- Name
- Required
- Default value
- Validation
6. Save form
### 4. Create Pages
**Via Page Builder:**
1. Open application
2. Navigate to "Pages"
3. Click "New Page"
4. Drag and drop components:
- Text
- Images
- Forms
- Lists
- Charts
- Buttons
5. Configure component properties
6. Save page
### 5. Build Reports
**Via Report Builder:**
1. Open application
2. Navigate to "Reports"
3. Click "New Report"
4. Configure:
- Data source (records)
- Columns
- Filters
- Sorting
- Grouping
- Formatting
5. Preview report
6. Save report
### 6. Create APIs
**Via API Builder:**
1. Open application
2. Navigate to "API"
3. Click "New API"
4. Configure:
- API name
- Endpoint
- Method (GET, POST, PUT, DELETE)
- Parameters
- Response format
5. Test API
6. Save API
### 7. Automate Workflows
**Via Automation:**
1. Open application
2. Navigate to "Automation" → "Triggers"
3. Create trigger:
- Event type (record created, updated, deleted)
- Conditions
- Actions (send email, update record, call API)
4. Save trigger
5. Configure script (if needed)
6. Test workflow
### 8. User Management
**Create User:**
1. Navigate to "Settings" → "Users"
2. Click "New User"
3. Configure:
- Username
- Email
- Password
- Role
- Profile
4. Click "Save"
**Manage Permissions:**
1. Navigate to "Settings" → "Roles"
2. Create/Edit role
3. Configure permissions:
- Access to modules
- Record operations (create, read, update, delete)
- Export/Import
- Admin functions
### 9. Data Management
**Import Data:**
1. Open application
2. Navigate to "Records"
3. Click "Import"
4. Select file (CSV, Excel, JSON)
5. Map columns to fields
6. Preview data
7. Click "Import"
**Export Data:**
1. Open application
2. Navigate to "Records"
3. Apply filters (if needed)
4. Click "Export"
5. Select format (CSV, Excel, JSON, PDF)
6. Download exported data
### 10. Theme Customization
**Customize Theme:**
1. Navigate to "Settings" → "Theme"
2. Configure:
- Brand colors
- Logo
- Font family
- Background
- Layout options
3. Preview changes
4. Save theme
## Architecture
```
┌─────────────┐
│ Browser │
│ (Web UI) │
└──────┬──────┘
HTTP Request
┌──────────────┐
│ Corteza │
│ (Go) │
│ Server │
└──────┬──────┘
┌────────────┼────────────┐
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ PostgreSQL│ │ Modules │ │ Storage │
│ (Database)│ │ (CRM, │ │ (/data) │
└──────────┘ │ Project, │ └──────────┘
│ etc.) │
└───────────┘
┌──────────┐
│ Web App │
│ (Client) │
└──────────┘
```
## Security
### User Authentication
- Multi-user support with role-based access
- Password hashing with bcrypt
- Session management
- SSO support (optional)
### Data Protection
- PostgreSQL encryption at rest
- Row-level permissions
- Secure API access
- Audit logging for all actions
### Network Security
- TLS/SSL support for secure connections
- API rate limiting
- CORS configuration
- Input sanitization
## Troubleshooting
### Application Not Loading
1. Verify PostgreSQL is running
2. Check Corteza service is started
3. Review connection settings
4. Check browser console for errors
5. Review Corteza logs: `docker logs <container>`
### Forms Not Working
1. Verify form permissions
2. Check field configuration
3. Review browser console for errors
4. Clear browser cache
### Performance Issues
1. Increase memory limit in Cloudron settings
2. Optimize database queries
3. Review record count
4. Consider data archival
### Import/Export Failures
1. Verify file format is correct
2. Check column mapping
3. Ensure permissions are correct
4. Review file size limits
## Documentation
For more information on using Corteza:
- [Official Website](https://cortezaproject.org)
- [Documentation](https://docs.cortezaproject.org)
- [GitHub Repository](https://github.com/cortezaproject/corteza)
- [Community Forum](https://cortezaproject.org/community)
- [Tutorials](https://cortezaproject.org/tutorials)
## Support
For issues and questions:
- [GitHub Issues](https://github.com/cortezaproject/corteza/issues)
- [Community Forum](https://cortezaproject.org/community)
- [Discord Server](https://discord.gg/corteza)
- [Contact](https://cortezaproject.org/contact)
## Upstream
[GitHub Repository](https://github.com/cortezaproject/corteza)
[Official Website](https://cortezaproject.org)

View File

@@ -0,0 +1 @@
<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 241.45 38.63"><defs><style>.cls-1{fill:#FF9661;}</style></defs><path class="cls-1" d="M2.51,9.38A18,18,0,0,1,9.37,2.51,19.49,19.49,0,0,1,19.13.05,19.15,19.15,0,0,1,30.21,3.3a17,17,0,0,1,6.64,9h-8.7A9,9,0,0,0,24.5,8.21a10.67,10.67,0,0,0-5.43-1.35A11.24,11.24,0,0,0,13.21,8.4a10.6,10.6,0,0,0-4,4.35,14.41,14.41,0,0,0-1.43,6.59,14.44,14.44,0,0,0,1.43,6.57,10.55,10.55,0,0,0,4,4.38,11.24,11.24,0,0,0,5.86,1.54,10.49,10.49,0,0,0,5.43-1.38,9.16,9.16,0,0,0,3.65-4.08h8.7a16.92,16.92,0,0,1-6.62,9,19.27,19.27,0,0,1-11.1,3.21,19.49,19.49,0,0,1-9.76-2.46,18,18,0,0,1-6.86-6.83A19.69,19.69,0,0,1,0,19.34,19.76,19.76,0,0,1,2.51,9.38Z"/><path class="cls-1" d="M50.43,36.15a18.53,18.53,0,0,1-7-6.89,19.28,19.28,0,0,1-2.59-10A19.13,19.13,0,0,1,43.4,9.38a18.46,18.46,0,0,1,7-6.89,20.29,20.29,0,0,1,19.48,0,18.37,18.37,0,0,1,7,6.89,19.31,19.31,0,0,1,2.56,9.91,19.45,19.45,0,0,1-2.56,10,18.38,18.38,0,0,1-7,6.89,20.31,20.31,0,0,1-19.45,0Zm15.72-5.81a10.53,10.53,0,0,0,4-4.4,14.38,14.38,0,0,0,1.46-6.65,14.2,14.2,0,0,0-1.46-6.62,10.4,10.4,0,0,0-4-4.35,12.72,12.72,0,0,0-12,0,10.34,10.34,0,0,0-4.08,4.35,14.32,14.32,0,0,0-1.46,6.62,14.51,14.51,0,0,0,1.46,6.65,10.47,10.47,0,0,0,4.08,4.4,12.5,12.5,0,0,0,12,0Z"/><path class="cls-1" d="M103.92,38.26,95.6,23.56H92v14.7H84.47V.54H98.62a16.49,16.49,0,0,1,7.46,1.54,10.8,10.8,0,0,1,4.62,4.16,11.32,11.32,0,0,1,1.54,5.86,11.23,11.23,0,0,1-2.16,6.73A11,11,0,0,1,103.65,23l9,15.3ZM92,17.89h6.32A6.33,6.33,0,0,0,103,16.4a5.52,5.52,0,0,0,1.51-4.13,5.29,5.29,0,0,0-1.51-4,6.5,6.5,0,0,0-4.6-1.43H92Z"/><path class="cls-1" d="M142.88.54V6.65h-10V38.26h-7.57V6.65H115.21V.54Z"/><path class="cls-1" d="M155.32,6.65V16.1H168v6h-12.7v10h14.32v6.16H147.75V.49h21.89V6.65Z"/><path class="cls-1" d="M185.42,31.88h17v6.38H176.66V32.42l16.86-25.5H176.66V.54h25.72V6.38Z"/><path class="cls-1" d="M231,31.07H216l-2.49,7.19h-7.94L219.08.49h8.81l13.56,37.77h-8ZM228.91,25,223.46,9.24,218,25Z"/></svg>

After

Width:  |  Height:  |  Size: 1.9 KiB