A TI-BASIC project publishes by upload. There is nothing to compile, so there is no repository, no manifest and no GitHub App.
The shape of it#
Create a project and choose TI-BASIC
The language is fixed once set, so a TI-BASIC project cannot later become an ASM/C one.
Open the Flight tab
Connecting the source needs no input at all. An upload source is created for you.
Write the listing
Title, summary, description, author, categories and tags. This belongs to the project, not to a version, so you write it once.
Publish a version
Attach the file and give it a version number. That is a release.
Publish the next version
Attach the new file, bump the version. The listing is reused.
The listing#
Written once, on the Flight page, and reused by every version afterwards.
Title1 to 64 charactersRequiredThe program name on Roost.
Summaryat most 140 charactersOne line. This is what appears in listings and search results.
Descriptionat most 4000 charactersThe long text on the program page.
Authorat most 64 charactersdefaults tothe project ownerWho to credit.
Categories1 to 4RequiredFrom the registry catalog.
Tagsup to 12Free-form.
Hiddenoff by defaultDownloadable by address, but left out of listings and search.
The publish button stays unavailable until the listing has everything a release needs, which is the console's way of telling you the listing is not finished yet.
Publishing a version#
Attach the file and give it a version number. That is the whole form: the listing is already on the project and is reused.
Fileusually an .8xpRequiredThe calculator file itself.
Versionat most 24 charactersRequiredNo format is enforced, but pick one convention and keep it.
Variable namedefaults toread from the fileOverride it only if the file carries the wrong one.
Variable typedefaults toread from the fileArchiveddefaults toread from the fileWhether the program should land in archive memory.
What you do not get#
| Repository projects | TI-BASIC | |
|---|---|---|
| Build log | yes | there is no build |
| Build on push | yes | no |
| Dependencies | yes | no |
| Manifest in the repository | yes | the listing is in the console |
| Library archive | libraries only | no |
Dependencies are the one that occasionally surprises people. A TI-BASIC program cannot declare that it needs a library, because TI-BASIC programs do not link against LibLoad libraries.
Moving to ASM/C later#
You cannot. The language is fixed once set.
If a TI-BASIC program grows into a C program, create a second project at a new address, and archive the first one with a description pointing at the new one. Both addresses stay claimed, which is the whole point of them being permanent.