hexlet-basics

Setup

Requirements

• make
• docker
• ruby = 4.0.1
• node >= 21

Run

1. Install system deps

# Ubuntu
make setup-ubuntu

# MacOS
make setup-macos

2. Run services (pg)

make services-start

By default the local Postgres is published on port 5433, so it does not conflict with another local database on 5432.

3. Setup app

make setup

4. Run

make dev # run server

Open https://code-basics.localhost

Port 3000 is the internal Puma app port. Do not open https://localhost:3000 directly; local HTTPS goes through Caddy on https://code-basics.localhost.

Admin Access: (login: full@test.io, password: password)

5. Development And Testing

make test # run tests

# load language (course)
make language-load L=php

make sync # sync locales, types, fixtures

Production

Kube access

# make k8s-macos-setup or make k8s-ubuntu-setup
export TWC_TOKEN=<your token>

Deploy

• Create new tag via command:

  make next-tag

• Wait notification about ready tag in Slack channel #sideprojects-code-auto or wait Github Actions

• Change version in k8s/hb-app-chart/values.yaml and then:

  make -C k8s helm-upgrade-app

TODO

1. switch to yandex postbox (smtp)
2. theme switcher
3. https://github.com/DavidWells/analytics
4. auth: vk id, yandex id, google id (except ru)
5. upload course image in admin interface (and remove devicon)
6. configus => dotenv
7. Check if yandex.market is used
8. primary keys: integer = bigint
9. add rss to blog

---

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.