Skip to content

Make Echo seamless to run locally #597

Description

@fmhall

We want Echo to be extremely easy to run locally.

Users should be able to run:

git clone, cd echo, pnpm i, then pnpm dev, and it should work the first time on the majority of machines. Required dependencies, like docker compose, should be clearly defined.

After a user runs pnpm dev, they should be able to navigate to http://localhost:3000/ and have an experience similar to production (https://echo.merit.systems/).

Related to #310

Ask:

  • Try running echo locally with a fresh clone
  • Any issues or confusions you run into, please log here
  • Any pnpm commands that are required but not properly documented, please indicate here (I.e. setting up DBs)
  • Make a PR that addresses the issues you ran into, and includes any other quality of life improvements you can find.
  • Include best practices in the readme and documentation.

Activity

  1. aybanda commented on Oct 22, 2025

    @aybanda

    /attempt #597

  2. added a commit that references this issue on Oct 22, 2025
  3. Abidoyesimze commented on Oct 26, 2025

    @Abidoyesimze

    Hi @fmhall can I take on this issue

  4. nehaaprasad commented on Nov 14, 2025

    @nehaaprasad

    Hello! @fmhall
    i have implemented a one-command automated setup that makes Echo work locally with just pnpm setup - no more manual Docker/PostgreSQL configuration needed.

  5. added a commit that references this issue on Feb 18, 2026
    f465dde
  6. 285729101 commented on Feb 18, 2026

    @285729101

    PR: #723

    Added a pnpm setup command that handles Docker/Postgres checks, copies env examples, runs migrations, and seeds. Also cleaned up the README to reflect the streamlined flow.

  7. added 2 commits that reference this issue on Apr 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions