chore: adiciona .gitignore e commit.command

2026-08-18 08:25:29 -04:00
parent 68958fde00
commit 8fca456ceb
215 changed files with 65752 additions and 0 deletions
@@ -0,0 +1,2 @@
+github: kitlangton
+
@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - Version [e.g. 22]
+
+
+**Additional context**
+Add any other context about the problem here.
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
@@ -0,0 +1,96 @@
+# GitHub Actions Workflows for Hex
+
+This directory contains the CI/CD workflows for the Hex project.
+
+## Workflows
+
+### 1. CI (`ci.yml`)
+- **Trigger**: On every push to main and pull requests
+- **Purpose**: Continuous integration for code quality
+- **Jobs**:
+  - Swift linting with SwiftLint
+  - Build and test in both Debug and Release configurations
+  - Caches Swift Package Manager dependencies
+
+### 2. Build and Release (`build-and-release.yml`)
+- **Trigger**: On push to main and on version tags (v*)
+- **Purpose**: Build, test, and create releases
+- **Jobs**:
+  - Build and test the app
+  - Create release artifacts when a tag is pushed
+  - Generate DMG installer
+  - Create GitHub release with changelog
+
+### 3. Manual Release (`release.yml`)
+- **Trigger**: Manual workflow dispatch
+- **Purpose**: Create signed and notarized releases
+- **Inputs**:
+  - Version number (e.g., 0.2.4)
+  - Build number (e.g., 37)
+- **Features**:
+  - Code signing and notarization
+  - DMG creation
+  - Sparkle appcast update support
+
+## Required Secrets
+
+For the release workflows to work properly, you need to configure these secrets in your GitHub repository:
+
+### For Code Signing (release.yml)
+- `MACOS_CERTIFICATE`: Base64 encoded .p12 certificate
+- `MACOS_CERTIFICATE_PWD`: Password for the certificate
+- `KEYCHAIN_PWD`: Password for the temporary keychain
+- `DEVELOPMENT_TEAM`: Your Apple Developer Team ID (QC99C9JE59)
+
+### For Notarization (release.yml)
+- `APPLE_ID`: Your Apple ID email
+- `APPLE_ID_PASSWORD`: App-specific password for notarization
+- `TEAM_ID`: Your Apple Team ID
+
+### For Sparkle Updates (optional)
+- `AWS_ACCESS_KEY_ID`: For uploading to S3
+- `AWS_SECRET_ACCESS_KEY`: For uploading to S3
+- `SPARKLE_PRIVATE_KEY`: For signing Sparkle updates
+
+## Usage
+
+### Creating a Release
+
+1. **Using Tags** (Recommended for releases):
+   ```bash
+   git tag v0.2.4
+   git push origin v0.2.4
+   ```
+   This will trigger the build-and-release workflow.
+
+2. **Manual Release** (For signed/notarized releases):
+   - Go to Actions → Release → Run workflow
+   - Enter version and build numbers
+   - The workflow will handle signing, notarization, and release creation
+
+### Setting Up Secrets
+
+1. Go to Settings → Secrets and variables → Actions
+2. Add each required secret
+
+To create the certificate secret:
+```bash
+# Export your Developer ID certificate from Keychain Access as .p12
+# Then convert to base64:
+base64 -i certificate.p12 | pbcopy
+```
+
+### Sparkle Integration
+
+The workflows include placeholders for Sparkle appcast updates. To enable:
+
+1. Set up your S3 bucket for hosting updates
+2. Configure AWS credentials as secrets
+3. Implement the appcast update logic in the workflow
+
+## Notes
+
+- The CI workflow runs on every push and PR for quick feedback
+- Release builds are only created for version tags or manual triggers
+- All builds target macOS 15+ and Apple Silicon
+- SwiftLint is configured but set to continue on error to avoid blocking PRs