Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ever-co/ever-teams
Ever® Teams™ - Open Work and Project Management Platform - https://ever.team
https://github.com/ever-co/ever-teams
issue-tracker jira jira-alternative kanban linear productivity project-management react react-native team-management time-tracker time-tracking timetracking
Last synced: about 6 hours ago
JSON representation
Ever® Teams™ - Open Work and Project Management Platform - https://ever.team
- Host: GitHub
- URL: https://github.com/ever-co/ever-teams
- Owner: ever-co
- License: agpl-3.0
- Created: 2022-10-11T15:31:48.000Z (over 2 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-29T18:09:38.000Z (3 months ago)
- Last Synced: 2024-10-29T20:13:13.762Z (3 months ago)
- Topics: issue-tracker, jira, jira-alternative, kanban, linear, productivity, project-management, react, react-native, team-management, time-tracker, time-tracking, timetracking
- Language: TypeScript
- Homepage: https://ever.team
- Size: 38.6 MB
- Stars: 281
- Watchers: 11
- Forks: 47
- Open Issues: 188
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.MD
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Ever Teams Platform
[](https://gitpod.io/#https://github.com/ever-co/ever-teams)
[](https://spectrum.chat/gauzy)
[](https://gitter.im/ever-co/ever-gauzy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://www.codementor.io/evereq?utm_source=github&utm_medium=button&utm_term=evereq&utm_campaign=github)
## ⭐️ What is it?
[Ever® Teams™](https://app.ever.team) - Open Work and Project Management Platform.
**NOTE: Platform currently is in active development stage / WIP, please use with caution!**
## ✨ Features
Below is a list of the most important planned features:
- Work / Workforce Management
- Time Management / Time Tracking / Activity Tracking
- Productivity Tracking & Metrics
- Projects / Tasks & Issues Management
- Organizations / Teams
- Tags / Labels
- Integrations (GitHub, GitLab, Bitbucket, JIRA, etc.)
- Dark / Black / Light Themes
## 🌼 Screenshots
Show / Hide Screenshots
### Web Platform
### Mobile Apps (iOS/Android)
### Browser Extension
Note: Currently WIP, the screenshot is just a temporary picture :)
## 📊 Activity
## 🔗 Links
- **** - Ever® Teams™ Platform Web Application.
- **** - Ever® Teams™ Platform Demo Web Application.
- **** - Ever® Teams™ Platform Stage / Test Web Application.
- **** - Ever® Teams™ Platform Documentation (WIP).
- **** - Check more information about the Ever® Teams™ platform at the official website (WIP).
- **** - Check more information about the Ever® Gauzy™ Platform at the official website.
- **** - Get more information about our company products.
## ⚡️ Our Open Platforms
Ever® Teams™ Platform () is built on top of our Business Management Platform (ERP/CRM/HRM) - Ever® Gauzy™ Platform (), which itself is a part of our larger Open Platform for On-Demand and Sharing Economies - Ever®. You can get more information about all our products at .
## 🧱 Technology Stack and Requirements
- [TypeScript](https://www.typescriptlang.org)
- [Nx](https://nx.dev) and [Lerna](https://github.com/lerna/lerna)
- [NodeJs](https://nodejs.org)
- [Next.js](https://nextjs.org)
- [React](https://reactjs.org)
- [React Native](https://reactnative.dev)
- [Expo](https://expo.dev)
- [Tailwind](https://tailwindcss.com) - CSS / Styles
- [shadcn/ui](https://ui.shadcn.com), [Radix](https://www.radix-ui.com) and [HeadlessUI](https://headlessui.com) - UI Component Libraries
- [DigitalOcean](https://www.digitalocean.com) and [Vercel](https://vercel.com) - Hosting
#### See also README.md and CREDITS.md files in relevant folders for lists of libraries and software included in the Platform, information about licenses, and other details
## 📄 Documentation
Please refer to our official [Platform Documentation](https://docs.ever.team) (WIP) and to our [Wiki](https://github.com/ever-co/ever-teams/wiki) (WIP).
## 🚀 Getting Starting
### Super Quick Start
### Run with Docker Compose
- Clone repo.
- Make sure you have the latest Docker Compose [installed locally](https://docs.docker.com/compose/install). Important: you need a minimum [v2.20](https://docs.docker.com/compose/release-notes/#2200).
- Run `docker-compose -f docker-compose.demo.yml up`, if you want to run the platform in basic configuration (e.g. for Demo / explore functionality / quick run) using our prebuilt Docker images. Check `.env.demo.compose` file for different settings (optionally). _(Note: Docker Compose will use latest images pre-build automatically from head of `master` branch using GitHub CI/CD.)_
- Run `docker-compose up`, if you want to run the platform in production configuration using our prebuilt Docker images. Check `.env.compose` file for different settings (optionally). _(Note: Docker Compose will use latest images pre-build automatically from head of `master` branch using GitHub CI/CD.)_
- Run `docker-compose -f docker-compose.build.yml up`, if you want to build everything (code and Docker images) locally. Check `.env.compose` file for different settings (optionally). _(Note: this can be long process because it builds whole platform locally. Other options above are much faster!)_
- :coffee: time... It might take some time for the first Docker Compose run, even if you used prebuilt Docker images.
- Open in your browser, register a new account, and start using Ever Teams!
- Enjoy!
_Notes:_
- _You can execute `docker-compose` command with `-d` option to run it in the "detached" mode (allows containers to run in the background, separate from the terminal)._
- _By default, Ever Teams web frontend will be connected to our production [Ever Gauzy API](https://github.com/ever-co/ever-gauzy) API endpoint . You can change it in environment variables `GAUZY_API_SERVER_URL` and `NEXT_PUBLIC_GAUZY_API_SERVER_URL`, see more in the section about how to run with a Self-hosted Backend._
### Run with Docker
#### Build & Run
Run with Public Images:
- You can pull our public docker image with `docker pull everco/ever-teams-webapp .` command.
- You can run docker image with the following command: `docker run -p 127.0.0.1:3030:3030/tcp everco/ever-teams-webapp`.
- Open in your browser, register a new account, and start using Ever Teams!
_Note: To build such images on each release (push to our master branch), we are using relevant [Github Action](https://github.com/ever-co/ever-teams/blob/develop/.github/workflows/docker-build-publish-prod.yml)._
Build and Run Locally:
- If you want to build an image locally from our source code (after clone repo locally), please run the following command (from the root of mono-repo): `docker build . -t ever-teams-webapp -f Dockerfile`.
- To run the locally built image, please run the following command: `docker run -p 127.0.0.1:3030:3030/tcp ever-teams-webapp`.
- Open in your browser, register a new account, and start using Ever Teams!
_Note: By default, Ever Teams web frontend will be connected to our production [Ever Gauzy API](https://github.com/ever-co/ever-gauzy) API endpoint . You can change it in environment variables `GAUZY_API_SERVER_URL` and `NEXT_PUBLIC_GAUZY_API_SERVER_URL`, see more in the section about how to run with a Self-hosted Backend._
#### Images
We have Ever Teams Docker images published into:
- https://hub.docker.com/u/everco?page=1&search=ever-teams
- https://github.com/orgs/ever-co/packages?tab=packages&q=ever-teams
### Quick Start to manually build & run locally
1. Clone this repo
2. Run `yarn install`
3. Run `yarn build:web && yarn start:web` OR `yarn start:web:dev`
4. Open in in your Browser
_Notes:_
- _by default, Ever Teams web frontend will be connected to our production [Ever Gauzy API](https://github.com/ever-co/ever-gauzy) API endpoint . You can change it in environment variables `GAUZY_API_SERVER_URL` and `NEXT_PUBLIC_GAUZY_API_SERVER_URL`, see below how to run with a Self-hosted Backend._
### Run with a Self-hosted Backend
1. Download and run the Ever Gauzy Server setup () or run the server manually (see ). You can also run only Ever Gauzy APIs (manually), see . For getting starting instructions, it's best to check the Ever Gauzy [README](https://github.com/ever-co/ever-gauzy/blob/develop/README.md) file.
2. Clone this repo
3. After you get the API or Server running, make sure you set the environment variables `GAUZY_API_SERVER_URL` and `NEXT_PUBLIC_GAUZY_API_SERVER_URL` in Ever Teams .env file (see ). For example, you can set those env vars to if Gauzy APIs run on that host & port.
4. Run `yarn install`
5. Run `yarn build:web && yarn start:web` OR `yarn start:web:dev`
6. Open in in your Browser
#### Notes
Note: Ever® Teams™ requires access to Ever® Gauzy™ Platform APIs, provided by another project - Ever® Gauzy™ Platform, see (and also ). Specifically, you might be interested in the `apps/api` and `apps/server` folders of the mono-repo for the Gauzy API & Gauzy Server code.
### Run in Gitpod
- Launch a ready-to-use Gitpod workspace (WIP):
[](https://gitpod.io/#https://github.com/ever-co/ever-teams)
### Run in DevContainer
DevContainers for VSCode are supported (WIP).
[Click here to get started.](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/ever-co/ever-teams)
## 🚗 Self Hosting
### DigitalOcean
Please see our [Wiki](https://github.com/ever-co/ever-teams/wiki/Deploy-to-DigitalOcean).
### Vercel
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fever-co%2Fever-teams&project-name=ever-teams&repository-name=ever-teams&output-directory=.next&build-command=yarn%20build&install-command=yarn%20install%20--frozen-lockfile&root-directory=apps%2Fweb)
### Render
[](https://render.com/deploy?repo=https://github.com/ever-co/ever-teams)
### Railway
[](https://railway.app/template/7_OfzR?referralCode=40jeja)
### Fly
[](https://github.com/ever-co/ever-teams/wiki/Deploy-to-Fly)
### Netlify
[](https://app.netlify.com/start/deploy?repository=https://github.com/ever-co/ever-teams)
### Heroku
[](https://heroku.com/deploy)
### Koyeb
[](https://app.koyeb.com/deploy?name=ever-teams&type=docker&builder=dockerfile&image=ghcr.io/ever-co/ever-teams-webapp:latest&env[PORT]=3030&ports=3030;http;/)
### Northflank
[Deploy to Northflank](https://app.northflank.com/s/account/templates/new?data=656ed069216b5d387f5379c6)
## 📄 Content
- `/apps/web` - NextJs-based (React) Web App at (deployed from `main` branch)
- `/apps/mobile` - Expo (ReactNative) powered mobile app
- `/apps/desktop` - Electron-based Desktop Application (customized build from [Ever Gauzy Desktop Timer App](https://github.com/ever-co/ever-gauzy/tree/develop/apps/desktop-timer))
- `/apps/extensions` - Browser Extensions (powered by )
- `/apps/server-api` - Ever Teams API Server (customized build from [Ever Gauzy API Server](https://github.com/ever-co/ever-gauzy/tree/develop/apps/server-api))
- `/apps/server-web` - Electron-based Ever Teams Web Server that serves Ever Teams NextJs frontend (wraps `apps/web` folder)
## 💌 Contact Us
- [Ever.co Website Contact Us page](https://ever.co/contacts)
- [Slack Community](https://join.slack.com/t/gauzy/shared_invite/enQtNzc5MTA5MDUwODg2LTI0MGEwYTlmNWFlNzQzMzBlOWExNTk0NzAyY2IwYWYwMzZjMTliYjMwNDI3NTJmYmM4MDQ4NDliMDNiNDY1NWU)
- [Discord Chat](https://discord.gg/hKQfn4j)
- [Spectrum Community](https://spectrum.chat/gauzy)
- [Gitter Chat](https://gitter.im/ever-co/gauzy)
- [CodeMentor](https://www.codementor.io/evereq)
- For business inquiries:
- Please report security vulnerabilities to
- [Gauzy Platform @ Twitter](https://twitter.com/gauzyplatform)
- [Gauzy Platform @ Facebook](https://www.facebook.com/gauzyplatform)
## 🔐 Security
**Ever Teams Platform** follows good security practices, but 100% security cannot be guaranteed in any software!
**Ever Teams Platform** is provided AS IS without any warranty. Use at your own risk!
See more details in the [LICENSES.md](LICENSES.md).
In a production setup, all client-side to server-side (backend, APIs) communications should be encrypted using HTTPS/WSS/SSL (REST APIs, GraphQL endpoint, Socket.io WebSockets, etc.).
If you discover any issue regarding security, please disclose the information responsibly by emailing and not by creating a GitHub issue.
## 🛡️ License
This software is available under the following licenses:
- [Ever® Teams™ Platform Community Edition](https://github.com/ever-co/ever-teams/blob/master/LICENSES.md#ever-teams-platform-community-edition-license)
- [Ever® Teams™ Platform Small Business](https://github.com/ever-co/ever-teams/blob/master/LICENSES.md#ever-teams-platform-small-business-license)
- [Ever® Teams™ Platform Enterprise](https://github.com/ever-co/ever-teams/blob/master/LICENSES.md#ever-teams-platform-enterprise-license)
#### The default Ever® Teams™ Platform license, without a valid Ever® Teams™ Platform Enterprise or Ever® Teams™ Platform Small Business License agreement, is the Ever® Teams™ Platform Community Edition License
We support the open-source community. If you're building awesome non-profit/open-source projects, we're happy to help and will provide (subject to [acceptance criteria](https://github.com/ever-co/ever-teams/wiki/Free-license-and-hosting-for-Non-profit-and-Open-Source-projects)) Ever Teams Enterprise edition license and free hosting option! Feel free to contact us at to make a request. More details are explained in our [Wiki](https://github.com/ever-co/ever-teams/wiki/Free-license-and-hosting-for-Non-profit-and-Open-Source-projects).
#### Please see [LICENSES](LICENSES.md) for more information on licenses
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fever-co%2Fever-teams?ref=badge_large)
## ™️ Trademarks
**Ever**® is a registered trademark of [Ever Co. LTD](https://ever.co).
**Ever® Demand™**, **Ever® Gauzy™**, **Ever® Teams™** and **Ever® OpenSaaS™** are all trademarks of [Ever Co. LTD](https://ever.co).
The trademarks may only be used with the written permission of Ever Co. LTD. and may not be used to promote or otherwise market competitive products or services.
All other brand and product names are trademarks, registered trademarks, or service marks of their respective holders.
## 🍺 Contribute
- Please give us a :star: on Github, it **helps**!
- You are more than welcome to submit feature requests in the [separate repo](https://github.com/ever-co/feature-requests/issues)
- Pull requests are always welcome! Please base pull requests against the _develop_ branch and follow the [contributing guide](.github/CONTRIBUTING.md).
## 💪 Thanks to our Contributors
See our contributors list in [CONTRIBUTORS.md](https://github.com/ever-co/ever-teams/blob/develop/.github/CONTRIBUTORS.md).
You can also view a full list of our [contributors tracked by Github](https://github.com/ever-co/ever-teams/graphs/contributors).
## ⭐ Star History
[](https://star-history.com/#ever-co/ever-teams&Date)
## ❤️ Powered By
## ©️ Copyright
#### Copyright © 2022-present, Ever Co. LTD. All rights reserved
---
[](https://circleci.com/gh/ever-co/ever-teams)
[](https://codecov.io/gh/ever-co/ever-teams)
[](https://www.codacy.com/gh/ever-co/ever-teams/dashboard?utm_source=github.com&utm_medium=referral&utm_content=ever-co/ever-teams&utm_campaign=Badge_Grade)
[](https://deepscan.io/dashboard#view=project&tid=3293&pid=25855&bid=814579)
[](https://snyk.io/test/github/ever-co/ever-teams)
[](https://lgtm.com/projects/g/ever-co/ever-teams/alerts/)
[](https://lgtm.com/projects/g/ever-co/ever-teams/context:javascript)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fever-co%2Fever-teams?ref=badge_shield)
[](https://ever.crowdin.com/ever-teams)
## 🔥 P.S
- If you are running any business or doing freelance, check our new project [Ever Gauzy](https://github.com/ever-co/ever-gauzy) - Open Business Management Platform (ERP/CRM/HRM)
- [We are Hiring: remote TypeScript / NodeJS / NestJS / Angular & React developers](https://github.com/ever-co/jobs#available-positions)