Сайт NU31 Hacker Space

Поки що цей проект — це просто ось цей сайт, але амбіції в нього дуже великі.

Короткий backlog

• Додати widget з google maps
• Додати логін через Discord
• Додати щось по типу блогу, я вірю в те, що це може стати гарним місцем для документації про проекти, або якоїсь іншої штуки, а так то мені цікаво написати blog і тому це тут буде.

Технології

Основна філософія проекту — це зробити роботу з кодом максимально простою, для того, щоб більше людей могли доєднатися до його розробки.

Проект — це monorepo, в якому і сайт, і backend до нього. Проект написаний на Nuxt 4, як з цим працювати можна почитати тут.

Ми для роботи з CSS використовуємо tailwind 4 Як база даних — MongoDB, через те, що вона не потребує додаткових дій для роботи з базою даних, якщо ви хочете щось додати, просто додайте.

Як запустити

Проекту для роботи треба mongo db. Для локальної розробки рекомендую просто запусти її в docker Для MacOS рекомендую використовувати colima, воно реально працює краще.

Запустити mongo в docker можна ось цією командою

docker run --name mongodb -p 27017:27017 -d mongodb/mongodb-community-server:latest

1. Зробіть git clone
2. Встановіть залежності

npm install

3. Запустіть development server, буде доступний за адресою http://localhost:3000,

npm run dev

Якщо на вашому комп'ютері 3000 зайнятий, буде спроба запуститися на 3001, 3002, ...

Робота через Dev Container з Colima

Проект підтримує розробку через Dev Containers. Щоб не засмічувати основну систему, ви можете створити окрему віртуальну машину (VM) для Docker за допомогою Colima з виділеною IP-адресою:

1. Створіть та запустіть окрему VM в Colima з виділеною мережевою адресою (потрібен встановлений colima):

   colima start nu31space --network-address --cpu 4 --memory 8

2. Colima автоматично налаштує новий Docker context (colima-nu31space). Перевірити IP-адресу вашої нової VM можна командою:

   colima list

3. Відкрийте проект у VS Code (або іншому редакторі з підтримкою Dev Containers) і виберіть опцію "Reopen in Container" (або "Відкрити в контейнері").

Dev Container автоматично запустить:

• Node.js середовище для роботи з Nuxt
• MongoDB базу даних
• Mongo Express (веб-інтерфейс для бази даних) доступний за адресою http://localhost:8081 (або по IP віртуальної машини: http://<COLIMA_IP>:8081)

Після підключення до контейнера:

1. Залежності (npm install) будуть встановлені автоматично.
2. Запустіть сервер: npm run dev
3. Сайт буде доступний на http://localhost:3000 (порт буде автоматично прокинутий на вашу хост-машину).

Проект відкритий до будь-якої допомоги

• знайшли помилку в Readme чи знаєте, як зробити його краще, сміло робіть pull request
• хочете зробити круту фічу чи поправити баг, сміло робіть pull request
• не знаєте, за що взятися, перевірте список issue, думаю, там щось є

P.S. Знайшли проблему, але не знаєте, як її вирішити, створіть issue, ось тут