71d4315ef0
* docs:Added hindi translation for contribution guides. * feat:Included the hindi translation link to other language files. --------- Co-authored-by: Anoop M D <anoop.md1421@gmail.com>
4.0 KiB
English | Українська | Русский | Türkçe | Deutsch | Français | বাংলা | हिंदी | 简体中文 | 正體中文
Давайте зробимо Bruno краще, разом !!
Я дуже радий що Ви бажаєте покращити Bruno. Нижче наведені вказівки як розпочати розробку Bruno на Вашому комп'ютері.
Стек технологій
Bruno побудований на Next.js та React. Також для десктопної версії (яка підтримує локальні колекції) використовується Electron
Бібліотеки, які ми використовуємо
- CSS - Tailwind
- Редактори коду - Codemirror
- Керування станом - Redux
- Іконки - Tabler Icons
- Форми - formik
- Валідація по схемі - Yup
- Клієнт запитів - axios
- Спостерігач за файловою системою - chokidar
Залежності
Вам знадобиться Node v18.x або остання LTS версія та npm 8.x. Ми використовуєм npm workspaces в цьому проекті
Починаєм писати код
Будь ласка, зверніться до development_ua.md за інструкціями щодо запуску локального середовища розробки.
Створення Pull Request-ів
- Будь ласка, робіть PR-и маленькими і сфокусованими на одній речі
- Будь ласка, слідуйте формату назв гілок
- feature/[назва feature]: Така гілка має містити зміни лише щодо конкретної feature
- Приклад: feature/dark-mode
- bugfix/[назва баґу]: Така гілка має містити лише виправлення конкретного багу
- Приклад: bugfix/bug-1
- feature/[назва feature]: Така гілка має містити зміни лише щодо конкретної feature
Розробка
Bruno розробляється як декстопний застосунок. Вам потрібно запустити Next.js в одній сесії терміналу, та запустити застосунок Electron в іншій сесії терміналу.
Залежності
- NodeJS v18
Локальна розробка
# Використовуйте nodejs 18-ї версії
nvm use
# встановіть залежності
npm i --legacy-peer-deps
# зберіть документацію graphql
npm run build:graphql-docs
# зберіть bruno query
npm run build:bruno-query
# запустіть додаток next (термінал 1)
npm run dev:web
# запустіть додаток електрон (термінал 2)
npm run dev:electron
Усунення несправностей
Ви можете зтикнутись із помилкою Unsupported platform коли запускаєте npm install. Щоб усунути цю проблему, вам потрібно видалити node_modules та package-lock.json, і тоді запустити npm install. Це має встановити всі потрібні для запуску додатку пекеджі.
# Видаліть node_modules в піддиректоріях
find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do
rm -rf "$dir"
done
# Видаліть package-lock в піддиректоріях
find . -type f -name "package-lock.json" -delete
Тестування
# bruno-schema
npm test --workspace=packages/bruno-schema
# bruno-lang
npm test --workspace=packages/bruno-lang