Skip to content

Improve repository setup#16

Merged
illicitonion merged 5 commits intomainfrom
chore/improve-setup
Jun 2, 2025
Merged

Improve repository setup#16
illicitonion merged 5 commits intomainfrom
chore/improve-setup

Conversation

@textbook
Copy link
Member

@textbook textbook commented Jun 1, 2025

Fix some of the initial issues (see 🧵 Slack thread) on starting up the repository. Add quickstart script to the README and:

  • Rationalise env variable usage

    Docker startup in db/run.sh now uses backend/.env as an env file, so env var naming follows the container's usage

  • Add appropriate VS Code configuration

    • Use created virtualenv
    • Host frontend on correct root path
  • Add missing dependencies

    • Install requests and psycopg2 for Python
    • Sync the package-lock.json file

textbook added 3 commits June 1, 2025 17:51
- Install and configure live server
- Fix installation requirements
- Rationalise git ignore files
- Source .env when loading DB
Copy link
Member

@illicitonion illicitonion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for putting this together!

Some of this is intentional (instructions in codebases get out of sync from reality, and often aren't documented as clearly as we'd like), but I agree this is a pretty big list. Can you revert the changes to the root README.md, and remove the quickstart.sh? Happy to discuss, but "the instructions are in a file other than the root README" feels realistic, "a script assumes docker is installed which isn't documented" feels pretty realistic, and "I'm not quite sure what to put in the .env file" feels annoying but realistic... Otherwise LGTM!

@textbook textbook force-pushed the chore/improve-setup branch from 92afd29 to a4e20c3 Compare June 2, 2025 08:23
@textbook textbook requested a review from illicitonion June 2, 2025 08:25
Copy link
Member

@illicitonion illicitonion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perfect, thanks!

@illicitonion illicitonion merged commit ea4cb25 into main Jun 2, 2025
@github-project-automation github-project-automation bot moved this from Backlog to Done in Purple Forest Kanban Jun 2, 2025
@illicitonion illicitonion deleted the chore/improve-setup branch June 2, 2025 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants