Getting Started

Get started with GitFables and learn how to generate stories from your Git repositories.

1

Overview

GitFables helps you generate engaging stories from your Git repositories.

Key features:

  • Automated story generation from Git history
  • Customizable story templates
  • Team collaboration tools
  • Integration with popular development tools
3

Basic Usage

Generate your first story in minutes.

  1. Install GitFables
  2. Connect your repository
  3. Choose a story template
  4. Generate your first story
terminal
Bash
# Install GitFables
npm install -g gitfables-cli

# Generate a story
gitfables story create --repo ./my-project

Install GitFables CLI and create your first story

gitfables.config.json
JSON
{
  "repository": {
    "url": "https://github.com/user/repo",
    "branch": "main"
  },
  "templates": {
    "default": "technical-journey",
    "customPath": "./templates"
  },
  "output": {
    "format": "markdown",
    "directory": "./stories"
  }
}

Configure your GitFables project settings

templates/technical-journey.yaml
YAML
---
name: Technical Journey
description: A technical narrative of your project
variables:
  timeframe:
    start: "2024-01-01"
    end: "2024-02-01"
  focus:
    - architecture
    - performance
    - security
---

# Project Journey: {{ repository.name }}

## Overview
{{ repository.description }}

## Key Milestones
{{ milestones | format_list }}

Create a custom story template

4

Requirements

Make sure you have these prerequisites installed.

  • Node.js 18 or higher
  • Git 2.0 or higher
  • A GitFables account
  • Access to a Git repository

⚠️ Some features may require additional dependencies based on your use case.

5

Next Steps

After getting started, explore these advanced topics.

Advanced Features

  • Custom templates
  • Team collaboration
  • API integration
  • Automated workflows

Resources

  • API documentation
  • Example projects
  • Community templates
  • Best practices