mirrors/dbgate
1
0
Fork 0
mirror of https://github.com/dbgate/dbgate synced 2024-11-07 20:26:23 +00:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity
296 Commits 70 Branches 774 Tags 30 MiB
Svelte 45%
TypeScript 28%
JavaScript 26.4%
CSS 0.3%
Shell 0.2%
Other 0.1%
752baf8d52
Go to file
Jan Prochazka 752baf8d52 v0.5.3
2020-05-18 20:25:42 +02:00
.github/workflows fix 2020-05-18 19:35:14 +02:00
.vscode mssql - incremental analysis 2020-04-11 20:24:30 +02:00
app v0.5.3 2020-05-18 20:25:42 +02:00
docker docker build 2020-03-15 21:10:38 +01:00
packages electron app 2020-05-18 19:05:45 +02:00
patches deploy WIP 2020-03-14 09:54:34 +01:00
.gitignore refactor 2019-12-26 20:08:51 +01:00
LICENSE Initial commit 2019-12-24 15:56:00 +01:00
package.json runAsPortal - connections from env variables, cannot be changed 2020-05-17 08:43:42 +02:00
prettier.config.js unified prettier 2020-03-05 13:32:42 +01:00
README.md fix 2020-04-13 21:23:24 +02:00
screenshot.png screenshot 2020-05-18 19:49:53 +02:00
yarn.lock api portal - run:portal uses env-cmd instead of cross-env 2020-05-17 08:57:52 +02:00

README.md

styled with prettier Donate

DbGate - database administration tool

DbGate is fast and efficient database administration tool. It uses JavaScript and TypeScript.

Currently implemented features

  • Browsing objects - tables, views, procedures, functions
  • Support for Microsoft SQL Server, Postgre SQL, MySQL
  • Table data browsing - filtering, sorting, adding related columns using foreign keys
  • Table data editing, with SQL change script preview
  • SQL editor, execute SQL script
  • Runs as application for Windows and Linux. Or in Docker container on server and in web Browser on client. (in future possibly on Mac - colaborators needed)

Screenshot

Design goals

  • Application simplicity - DbGate takes the best and only the best from old DbGate, DatAdmin and DbMouse . First will be implemented the most used features from this software.
  • Minimal dependencies - so that the software can be developed in future without problems with obsolete libraries
    • Frontend - React, styled-components, socket.io
    • Backend - NodeJs, ExpressJs, socket.io, database connection drivers
    • JavaScript + TypeScript
    • App - electron
    • There is plan to incorporate SQLite to support work with local datasets
  • Platform independed - will run as web application in single docker container on server, or as application using Electron platform on Linux, Windows and Mac

How Can I Contribute?

You're welcome to contribute to this project! Especially with these topics:

  • Mac support. App is build using electron, without native modules, so it should be very easy to build app for Mac
  • Styles, graphics
  • Better MySQL, Postgre SQL support
  • Github actions for publishing releases

Any help is appreciated!

Feel free to report issues and open merge requests.

How to run development environment

yarn
yarn start

If you want to make modifications in typescript packages, run TypeScript compiler in watch mode in seconds terminal:

yarn lib

Open http://localhost:5000 in your browser

You could run electron app, using this server:

cd app
yarn
yarn start

How to run built electron app locally

This mode is very similar to production run of electron app. Electron app forks process with API on dynamically allocated port, works with compiled javascript files.

cd app
yarn

yarn
yarn build:app:local
yarn start:app:local

Packages

  • api - backend, Javascript, ExpressJS
  • datalib - TypeScript library for utility classes
  • electron - application (JavaScript)
  • engines - drivers for database engine (mssql, mysql, postgres), analysing database structure, creating specific queries (JavaScript)
  • filterparser - TypeScript library for parsing data filter expressions using parsimmon
  • sqltree - JSON representation of SQL query, functions converting to SQL (TypeScript)
  • types - common TypeScript definitions
  • web - frontend in React (JavaScript)