Axoria
PT EN
Get started

Usage Guide - Axoria v1.0.0

This guide walks through the complete flow from registration to creating and managing issues in Axoria.

1. Creating Your Account

Go to /register and fill in:

Field Requirement
Username Unique, no spaces
Email Must use a public provider (Gmail, Outlook, etc.)
Password Minimum 8 characters with at least 1 special character

After signing up, log in at /login.

Note: Corporate email domains are not allowed for direct registration. Contact Axoria support for enterprise plans.

2. Creating an Organization

After your first login, you will be directed to the Dashboard. From there:

  1. Click "+ New Organization"
  2. Fill in the name and slug (e.g., my-company)
  3. Click "Create Organization"

The slug is the unique URL identifier and cannot be changed after creation.

3. Creating a Project

Inside the organization:

  1. Click "+ New Project"
  2. Define:
    • Name: descriptive (e.g., "Web Platform")
    • Key: short and uppercase (e.g., WEB) - issue prefix: WEB-1
    • Type: SOFTWARE, KANBAN, SCRUM, BUSINESS, or CUSTOM
  3. Click "Create Project"

4. Configuring the Project

After creating the project, go to Settings to customize:

Workflow

Create statuses that describe the lifecycle of your issues:

To Do → In Progress → In Review → Done

Configure which transitions are allowed between statuses.

Board

Configure columns and map each column to one or more workflow statuses.

Issue Types and Priorities

Enable or disable types (Task, Bug, Story, etc.) and priorities (Critical, High, Medium, etc.) according to your team's needs.

5. Adding Members

  1. Go to project Members
  2. Click "+ Add Member"
  3. Enter the user's email (must have an Axoria account and belong to the organization)
  4. Select the role: PROJECT_ADMIN, DEVELOPER, REPORTER, or VIEWER
  5. Confirm

6. Creating Issues

On the project Board:

  1. Click "+ Create Issue"
  2. Fill in:
    • Title (required)
    • Type: Task, Bug, Story, Epic, etc.
    • Priority: Critical, High, Medium, Low, Trivial
    • Assignees: project members
    • Description with full Markdown support
  3. Click "Create"

The issue will appear on the board at the workflow's initial status.

7. Managing Issues on the Board

Moving Issues

Drag cards between columns (drag-and-drop) or change the status in the details panel.

Details Panel

Click any card to open the side panel featuring:

  • Edit title, type, priority, and status
  • Add/remove assignees
  • Set start and due dates
  • Add comments
  • View change history

Filters

Use the board filter bar to view issues by:

  • Assignee
  • Type
  • Priority
  • Text in title

8. Working with Sprints

Creating a Sprint

In the Backlog:

  1. Click "+ Create Sprint"
  2. Set the name, goal, start date, and end date
  3. Drag issues from the backlog into the sprint

Starting the Sprint

Click "Start Sprint" when ready. Only one sprint can be active per project at a time.

Completing the Sprint

Click "Complete Sprint". Unfinished issues can be moved to the backlog or the next sprint.

9. Importing and Exporting Issues

Import

Prepare a CSV with columns title, type, priority, description, and upload it on the project's Import screen.

Export

Go to the project's Export screen, apply filters, and download the file in CSV or Excel format.

Next Steps

  • Explore the platform's features in the Changelog
  • Configure Webhooks in Settings → Webhooks for external integrations
  • Create Profile Groups in the organization for granular permissions
Use the sidebar to navigate through all documentation.