This document will introduce the programming languages, frameworks, tools and services with which we prefer to build and ship software. It also provides links to tools and guides to help you implement contribution rules and a branching strategy when setting up a new project.
Choosing the right tech stack depends on multiple factors, such as the software type, functionalities and requirements. It's impossible to cover all possibilities, nor is it our intention. However, we encourage contributors to align their stack as closely as possible to that described below so that other contributors are familiar with it. Also, this allows us to minimize the time spent preparing guides and tools for implementing our development workflow as documentation will be used for multiple projects.
Since most of the software we make is web-based or web-related, we use JavaScript as it's currently the dominant language in the web ecosystem. Besides, its ecosystem enables us to build almost any other type of software. Not being a type-safe language, JavaScript increases the chance of runtime errors, making it extremely difficult to read and maintain the project as it, or the team working on it, gets bigger. We prefer TypeScript over JavaScript because it has solved these issues, ensuring that we deliver safer software.
Next.js is an open-source React framework created by Vercel. We build frameworks on top of it to speed up our website development process.
- A framework that empowers Logos brands to build websites under the design system of Logos (see here)
Docusaurus is an open-source React framework created by Facebook for building documentation websites, which supports i18n, versioning, custom pages, MDX documents, customized themes, etc.
- Create highly customized documentation websites for Logos business units (see codex.storage, here and here)
We only intend to use Vercel for demo and test cases, but we're also temporarily deploying multiple Logos brand websites on it.
- Quickly deploy websites for demo and test cases
- Setup CI/CD pipelines and deploy Logos brand websites (vac.dev, waku.org, codex.storage)