diff --git a/DozerDB_logo.png b/DozerDB_logo.png new file mode 100644 index 000000000..50fdf356c Binary files /dev/null and b/DozerDB_logo.png differ diff --git a/README.md b/README.md index 66855796e..333619171 100644 --- a/README.md +++ b/README.md @@ -1,79 +1,124 @@ -# Neo4j Browser +
+
+
+ DozerDB Browser โ enhanced graph database UI built on Neo4j Browser +
- + -## Demo + -You can try out the latest (unreleased) version of Neo4j Browser at [http://browser-canary.graphapp.io/](http://browser-canary.graphapp.io/). +--- -Keep in mind that you will need to connect to an instance of Neo4j (the database) for most operations in Neo4j Browser. A simple way to get started is through [Neo4j Desktop](https://neo4j.com/download/). Once you've started a database it's by default available for Neo4j Browser to connect to on **localhost:7687**. +## ๐ About -## Feedback & Contributing +DozerDB Browser is the graphical user interface for DozerDB. Query, visualize, administer, and monitor your graph database with modern and easy-to-use tools. -Found a bug or some other problem with Neo4j Browser? Please [**open an issue**](https://github.com/neo4j/neo4j-browser/issues). +This project is a fork of [Neo4j Browser](https://github.com/neo4j/neo4j-browser) with DozerDB-specific enhancements. -Have an idea for a new feature? You're welcome to leave suggestions and ideas [here](https://feedback.neo4j.com/browser). + -Contributions welcome! More information in our [CONTRIBUTING.md](CONTRIBUTING.md). +--- -## Project structure +## ๐ Project Structure -Browser has a subproject of re-usable components bundled together and exposed as `neo4j-arc`. Rather than set up mono-repo tooling the we've set up eslint to isolate `neo4j-arc` and given it a seperate build step. Code in browser can only to import code from `neo4j-arc` through `neo4j-arc` aliases (as if it was a seperate project) and `neo4j-arc` is not allowed to import any code from outside it's own folder. +Browser has a subproject of reusable components bundled together and exposed as `neo4j-arc`. ESLint is configured to isolate `neo4j-arc` โ code in browser can only import from `neo4j-arc` through its aliases, and `neo4j-arc` cannot import code from outside its own folder. -## Development +--- -Running Neo4j Browser locally requires Node.js (^12.4.0) and for dependencies we use yarn (`npm install -g yarn`). -To install dependencies and then start the development server at `http://localhost:8080`: +## ๐ ๏ธ Development -```shell +### Prerequisites + +- **Node.js** ^12.4.0 +- **Yarn** โ install with `npm install -g yarn` + +### Getting Started + +Install dependencies and start the development server at `http://localhost:8080`: + +```bash yarn install yarn start ``` -Or to run in production mode: +To run in production mode: -```shell +```bash yarn start-prod ``` -### Testing overview +--- -Neo4j Browser has both unit and end to end tests running automatically on every pull request. To run the tests locally: +## ๐งช Testing -`yarn test-unit` runs a linter and then our unit tests. +### Unit Tests -`yarn test-e2e` runs our Cypress end to end tests in the easiest, slowest way. Running them with this command requires docker installed and that nothing else runs on ports 7687 and 8080. +Runs a linter followed by unit tests: -#### Cypress e2e test suite in depth +```bash +yarn test-unit +``` -`yarn e2e-open` to open the Cypress test runner (requires a **fresh** installation of Neo4j to run against, expects neo4j 3.5 by default). See details below on how to configure database version. +### End-to-End Tests -`yarn e2e-local-open` to run against an existing server (with a password already set). We use `newpassword` as the default password here, make sure to pass your password: -`yarn e2e-local-open --env browser-password=+ © 2026 DozerDB Contributors +