Configuration

Editing config.json

config.json is a lightweight JSON file with general configuration of your installation. It’s located at ./assets/data/ directory of your installation.

Structure of config.json

Parameter Name Description Default Value Valid Values

appTitle

Title of your Radar

Ginc Radar

*

language

Interface language

en

en, ru

Default config.json

{
  "appTitle": "Ginc Radar",
  "language": "en"
}

Filling radar.json

radar.json is a JSON file with radar data to visualise. It’s located at ./assets/data/ directory of your installation.

Structure of radar.json

Parameter Name Description Valid Values

sections

Array of sections

Length must be less or equal 4

sections.title

Section title

*

sections.color

Section background color

Valid HEX color

rings

Array of rings

Length must be less or equal 4

rings.title

Ring title

*

rings.radius

Ring radius as a percentage of the full radius

1..100

rings.arcWidth

Ring arc width in relative pixels

Expect a value of 400 to cover the entire radar

rings.tagColor

Background color of chips/tags with ring title on list-details views

Valid HEX color

items

Array of items (technologies)

items.title

Item title

*

items.section

Title of item section

items.ring

Title of item ring

items.description

Html of item description

items.tags

Array(String). Tags to sort items.

items.revisions

Array of item revisions

Expected at least one element

items.revisions

Array of item revisions

Expected at least one element

items.revisions.section

Title of revision section

items.revisions.ring

Title of revision ring

items.revisions.description

Html of item description

items.revisions.date

Date of revision

YYYY-MM-DD

Example of radar.json

radar.json
{
  "sections": [
    {
      "title": "Languages & Frameworks",
      "color": "#248ea6"
    },
    {
      "title": "Methods & Patterns",
      "color": "#84bfa4"
    },
    {
      "title": "Platforms & Operations",
      "color": "#f2a25c"
    },
    {
      "title": "Tools",
      "color": "#3fc480"
    }
  ],
  "rings": [
    {
      "title": "adopt",
      "radius": 44,
      "arcWidth": 6,
      "tagColor": "#5cb449"
    },
    {
      "title": "trial",
      "radius": 67,
      "arcWidth": 5,
      "tagColor": "#faa03d"
    },
    {
      "title": "access",
      "radius": 85,
      "arcWidth": 3,
      "tagColor": "#40a7d1"
    },
    {
      "title": "hold",
      "radius": 100,
      "arcWidth": 2,
      "tagColor": "#688190"
    }
  ],
  "items": [
    {
      "section": "Languages & Frameworks",
      "ring": "adopt",
      "title": "Java",
      "description": "Java is a multi-platform, object-oriented, and network-centric language that can be used as a platform in itself. It is a fast, secure, reliable programming language for coding everything from mobile apps and enterprise software to big data applications and server-side technologies.",
      "tags": [
        "Programming",
        "Backend"
      ],
      "revisions": [
        {
          "section": "Languages & Frameworks",
          "ring": "adopt",
          "description": "<p><b>Java</b> has proven itself as a reliable language for backend solutions.</p><p>LTS versions in use: <ul><li>17</li></ul></p>",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Languages & Frameworks",
      "ring": "adopt",
      "title": "Spring Boot",
      "description": "<p>Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can \"just run\".</p>",
      "tags": [
        "Programming",
        "Backend"
      ],
      "revisions": [
        {
          "section": "Languages & Frameworks",
          "ring": "adopt",
          "description": "<b>Spring Boot</b> has almost everything we need to solve our work tasks.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Languages & Frameworks",
      "ring": "adopt",
      "title": "JUnit",
      "description": "JUnit provides a modern foundation for developer-side testing on the JVM.",
      "tags": [
        "Programming",
        "Backend",
        "Testing"
      ],
      "revisions": [
        {
          "section": "Languages & Frameworks",
          "ring": "adopt",
          "description": "JUnit is a great testing framework with a lot of community support. We use it to test our code.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Languages & Frameworks",
      "ring": "adopt",
      "title": "TypeScript",
      "description": "<b>TypeScript</b> is a strongly typed programming language that builds on JavaScript, giving you better tooling at any scale.",
      "tags": [
        "Programming",
        "Frontend"
      ],
      "revisions": [
        {
          "section": "Languages & Frameworks",
          "ring": "adopt",
          "description": "<b>TypeScript</b> is the native language for Angular, providing good typing and code reliability.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Methods & Patterns",
      "ring": "adopt",
      "title": "OAuth 2.0",
      "description": "<b>OAuth 2.0</b> is the industry-standard protocol for authorization. <b>OAuth 2.0</b> focuses on client developer simplicity while providing specific authorization flows for web applications, desktop applications, mobile phones, and living room devices.",
      "tags": [
        "Security",
        "Architecture"
      ],
      "revisions": [
        {
          "section": "Methods & Patterns",
          "ring": "adopt",
          "description": "Our products have access division depending on the type of client. <b>OAuth 2.0</b> allows us to implement this in a standard way.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Methods & Patterns",
      "ring": "adopt",
      "title": "Diagrams as Code",
      "description": "<b>Diagrams as Code<b/> is essentially the process of managing diagrams through code rather than interactively drawing them on specific apps.",
      "tags": [
        "Documentation"
      ],
      "revisions": [
        {
          "section": "Methods & Patterns",
          "ring": "adopt",
          "description": "<b>Diagrams as Code</b> allows us to easily create, store and modify existing diagrams without installing of special applications.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Platforms & Operations",
      "ring": "adopt",
      "title": "PostgreSQL",
      "description": "<b>PostgreSQL</b> is a powerful, open source object-relational database system with over 35 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance.",
      "tags": [
        "SQL"
      ],
      "revisions": [
        {
          "section": "Platforms & Operations",
          "ring": "adopt",
          "description": "We store data in <b>PostgreSQL</b>. It is good enough to store both structured data and json.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Platforms & Operations",
      "ring": "adopt",
      "title": "Docker",
      "description": "<b>Docker</b> is an open platform for developing, shipping, and running applications. Docker enables you to separate your applications from your infrastructure so you can deliver software quickly. With Docker, you can manage your infrastructure in the same ways you manage your applications. By taking advantage of Docker's methodologies for shipping, testing, and deploying code, you can significantly reduce the delay between writing code and running it in production.",
      "tags": [
        "DevOps"
      ],
      "revisions": [
        {
          "section": "Platforms & Operations",
          "ring": "adopt",
          "description": "We use <b>Docker</b> in CI processes, for deployment and distribution.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Tools",
      "ring": "adopt",
      "title": "Ginc Radar",
      "description": "<b>Ginc Radar</b> is a software that provides tech radars management.",
      "tags": [
        "DevOps"
      ],
      "revisions": [
        {
          "section": "Tools",
          "ring": "adopt",
          "description": "We use <b>Ginc Radar</b> to manage our tech stack and track project dependencies.",
          "date": "2024-12-08"
        }
      ]
    },
    {
      "section": "Tools",
      "ring": "adopt",
      "title": "Git",
      "description": "<b>Git</b> is a distributed version control system that tracks versions of files. It is often used to control source code by programmers who are developing software collaboratively.",
      "tags": [],
      "revisions": [
        {
          "section": "Tools",
          "ring": "adopt",
          "description": "Git is the most widely used distributed VCS. Of course we chose this one.",
          "date": "2024-12-08"
        }
      ]
    }
  ]
}