# Envato Upload Guide

Use this when you need to upload a QuickCal release package to Envato / CodeCanyon.

## Build Files From GitHub

If you do not want to run local terminal commands:

1. Open the QuickCal GitHub repository
2. Click `Actions`
3. Open the `Build Envato Package` workflow
4. Click `Run workflow`
5. Wait for the workflow to finish
6. Download `_envato_submission.zip`

If you want GitHub to upload the Envato files directly:

1. Open the QuickCal GitHub repository
2. Click `Actions`
3. Open the `Upload To Envato` workflow
4. Click `Run workflow`
5. Wait for the workflow to finish
6. Open Envato Author Dashboard and complete the submission/update form

## Files You Will Use

Main upload package:

- `quickcal.zip`

Plugin zip if needed separately:

- `quickcal-plugin.zip`

Marketplace assets:

- included inside `_envato_submission.zip`

These include:

- preview image(s)
- icon image
- preview screenshots zip

## Envato FTP Details

Use these values in your FTP app:

- Host: `ftp.marketplace.envato.com`
- Port: `21`
- Encryption: explicit FTP over TLS
- Username: Envato username
- Password: Envato API token

If you do not have the password/token, ask the repo owner.

## Upload Steps

1. Build or download the latest QuickCal artifacts
2. Confirm you have:
   - `_envato_submission.zip`
3. Open your FTP client
4. Connect to `ftp.marketplace.envato.com`
5. Log in with the shared Envato credentials
6. Extract `_envato_submission.zip`
7. Upload the extracted files to the FTP root
7. Confirm the upload completed without errors
8. Finish the submission/update inside the Envato author interface if needed

## Before Uploading

Confirm these basics first:

- version number is correct
- release notes are correct
- `make smoke` passed for the release
- `_envato_submission.zip` was built successfully

## If Something Looks Wrong

If the GitHub artifacts look wrong:

1. Stop before uploading to Envato
2. Share the issue with the developer
3. Include:
   - screenshot of the artifact list
   - workflow run link
   - short note about what looks wrong
