athena-COMPONENT_NAME

Version, currently master branch1 version
  • master branchlatestDec 27, 2025

github.com/athena-framework/component-template

DESCRIPTION.

1 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  athena-COMPONENT_NAME:
    github: athena-framework/component-template
    branch: master

master is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
>= 0.36.0
License
MIT
Author
CREATOR_NAME <CREATOR_EMAIL>

Dependencies

This version declares no dependencies.

README

README

Template repo for creating a new Athena component. Scaffolds the Crystal shard's structure as well as define CI etc.

NOTE: This repo assumes the component will be in the athena-framework org. If it is to be used outside of the org, be sure to update URLs accordingly.

  1. Find/replace COMPONENT_NAME with the name of the component. This is used as the shard's name. E.x. logger. 1.1 Be sure to rename the file in ./src as well.

  2. Replace NAMESPACE_NAME with the name of the component's namespace. Documentation for this component will be grouped under this. E.x. Logger.

  3. Find/replace CREATOR_NAME with your Github display name. E.x. George Dietrich.

  4. Find/replace CREATOR_USERNAME with your Github username. E.x. blacksmoke16.

  5. Find/replace CREATOR_EMAIL with your desired email

    5.1 Can remove this if you don't wish to expose an email.

  6. Find/replace ALIAS_NAME with the three letter alias for this component; A + 2 letter shortcut to NAMESPACE_NAME. E.x. ALG.

  7. Find/replace DESCRIPTION with a short description of what the component does.

  8. Add some initial documentation to docs/README.md.

Delete from here up

NAMESPACE_NAME

Common Changelog CI Latest release

DESCRIPTION.

Getting Started

Checkout the Documentation.

Contributing

Read the general Contributing Guide for information on how to get started.