mirror of
https://github.com/makeplane/plane
synced 2025-08-07 19:59:33 +00:00
28f9733d1b
* chore: local dev improvements * chore: pr feedback * chore: fix setup * fix: env variables updated in .env.example files * fix(local): sign in to admin and web * chore: update minio deployment to create an bucket automatically on startup. * chore: resolve merge conflict * chore: updated api env with live base path --------- Co-authored-by: sriram veeraghanta <veeraghanta.sriram@gmail.com> Co-authored-by: pablohashescobar <nikhilschacko@gmail.com>
192 lines
8.7 KiB
Markdown
192 lines
8.7 KiB
Markdown
<br /><br />
|
||
|
||
<p align="center">
|
||
<a href="https://plane.so">
|
||
<img src="https://plane-marketing.s3.ap-south-1.amazonaws.com/plane-readme/plane_logo_.webp" alt="Plane Logo" width="70">
|
||
</a>
|
||
</p>
|
||
<h1 align="center"><b>Plane</b></h1>
|
||
<p align="center"><b>Open-source project management that unlocks customer value</b></p>
|
||
|
||
<p align="center">
|
||
<a href="https://discord.com/invite/A92xrEGCge">
|
||
<img alt="Discord online members" src="https://img.shields.io/discord/1031547764020084846?color=5865F2&label=Discord&style=for-the-badge" />
|
||
</a>
|
||
<img alt="Commit activity per month" src="https://img.shields.io/github/commit-activity/m/makeplane/plane?style=for-the-badge" />
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://plane.so/"><b>Website</b></a> •
|
||
<a href="https://github.com/makeplane/plane/releases"><b>Releases</b></a> •
|
||
<a href="https://twitter.com/planepowers"><b>Twitter</b></a> •
|
||
<a href="https://docs.plane.so/"><b>Documentation</b></a>
|
||
</p>
|
||
|
||
<p>
|
||
<a href="https://app.plane.so/#gh-light-mode-only" target="_blank">
|
||
<img
|
||
src="https://plane-marketing.s3.ap-south-1.amazonaws.com/plane-readme/plane_screen.webp"
|
||
alt="Plane Screens"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
<a href="https://app.plane.so/#gh-dark-mode-only" target="_blank">
|
||
<img
|
||
src="https://plane-marketing.s3.ap-south-1.amazonaws.com/plane-readme/plane_screens_dark_mode.webp"
|
||
alt="Plane Screens"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
|
||
Meet [Plane](https://plane.so/), an open-source project management tool to track issues, run ~sprints~ cycles, and manage product roadmaps without the chaos of managing the tool itself. 🧘♀️
|
||
|
||
> Plane is evolving every day. Your suggestions, ideas, and reported bugs help us immensely. Do not hesitate to join in the conversation on [Discord](https://discord.com/invite/A92xrEGCge) or raise a GitHub issue. We read everything and respond to most.
|
||
|
||
## 🚀 Installation
|
||
|
||
Getting started with Plane is simple. Choose the setup that works best for you:
|
||
|
||
- **Plane Cloud**
|
||
Sign up for a free account on [Plane Cloud](https://app.plane.so)—it's the fastest way to get up and running without worrying about infrastructure.
|
||
|
||
- **Self-host Plane**
|
||
Prefer full control over your data and infrastructure? Install and run Plane on your own servers. Follow our detailed [deployment guides](https://developers.plane.so/self-hosting/overview) to get started.
|
||
|
||
| Installation methods | Docs link |
|
||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||
| Docker | [](https://developers.plane.so/self-hosting/methods/docker-compose) |
|
||
| Kubernetes | [](https://developers.plane.so/self-hosting/methods/kubernetes) |
|
||
|
||
`Instance admins` can configure instance settings with [God mode](https://developers.plane.so/self-hosting/govern/instance-admin).
|
||
|
||
## 🌟 Features
|
||
|
||
- **Issues**
|
||
Efficiently create and manage tasks with a robust rich text editor that supports file uploads. Enhance organization and tracking by adding sub-properties and referencing related issues.
|
||
|
||
- **Cycles**
|
||
Maintain your team’s momentum with Cycles. Track progress effortlessly using burn-down charts and other insightful tools.
|
||
|
||
- **Modules**
|
||
Simplify complex projects by dividing them into smaller, manageable modules.
|
||
|
||
- **Views**
|
||
Customize your workflow by creating filters to display only the most relevant issues. Save and share these views with ease.
|
||
|
||
- **Pages**
|
||
Capture and organize ideas using Plane Pages, complete with AI capabilities and a rich text editor. Format text, insert images, add hyperlinks, or convert your notes into actionable items.
|
||
|
||
- **Analytics**
|
||
Access real-time insights across all your Plane data. Visualize trends, remove blockers, and keep your projects moving forward.
|
||
|
||
- **Drive** (_coming soon_): The drive helps you share documents, images, videos, or any other files that make sense to you or your team and align on the problem/solution.
|
||
|
||
|
||
## 🛠️ Local development
|
||
|
||
See [CONTRIBUTING](./CONTRIBUTING.md)
|
||
|
||
## ⚙️ Built with
|
||
[](https://nextjs.org/)
|
||
[](https://www.djangoproject.com/)
|
||
[](https://nodejs.org/en)
|
||
|
||
## 📸 Screenshots
|
||
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Issues_rNZjrGgFl.png?updatedAt=1709298765880"
|
||
alt="Plane Views"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Cycles_jCDhqmTl9.png?updatedAt=1709298780697"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Modules_PSCVsbSfI.png?updatedAt=1709298796783"
|
||
alt="Plane Cycles and Modules"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Views_uxXsRatS4.png?updatedAt=1709298834522"
|
||
alt="Plane Analytics"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Analytics_0o22gLRtp.png?updatedAt=1709298834389"
|
||
alt="Plane Pages"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
</p>
|
||
<p>
|
||
<a href="https://plane.so" target="_blank">
|
||
<img
|
||
src="https://ik.imagekit.io/w2okwbtu2/Drive_LlfeY4xn3.png?updatedAt=1709298837917"
|
||
alt="Plane Command Menu"
|
||
width="100%"
|
||
/>
|
||
</a>
|
||
</p>
|
||
</p>
|
||
|
||
## 📝 Documentation
|
||
Explore Plane's [product documentation](https://docs.plane.so/) and [developer documentation](https://developers.plane.so/) to learn about features, setup, and usage.
|
||
|
||
## ❤️ Community
|
||
|
||
Join the Plane community on [GitHub Discussions](https://github.com/orgs/makeplane/discussions) and our [Discord server](https://discord.com/invite/A92xrEGCge). We follow a [Code of conduct](https://github.com/makeplane/plane/blob/master/CODE_OF_CONDUCT.md) in all our community channels.
|
||
|
||
Feel free to ask questions, report bugs, participate in discussions, share ideas, request features, or showcase your projects. We’d love to hear from you!
|
||
|
||
## 🛡️ Security
|
||
|
||
If you discover a security vulnerability in Plane, please report it responsibly instead of opening a public issue. We take all legitimate reports seriously and will investigate them promptly. See [Security policy](https://github.com/makeplane/plane/blob/master/SECURITY.md) for more info.
|
||
|
||
To disclose any security issues, please email us at security@plane.so.
|
||
|
||
## 🤝 Contributing
|
||
|
||
There are many ways you can contribute to Plane:
|
||
|
||
- Report [bugs](https://github.com/makeplane/plane/issues/new?assignees=srinivaspendem%2Cpushya22&labels=%F0%9F%90%9Bbug&projects=&template=--bug-report.yaml&title=%5Bbug%5D%3A+) or submit [feature requests](https://github.com/makeplane/plane/issues/new?assignees=srinivaspendem%2Cpushya22&labels=%E2%9C%A8feature&projects=&template=--feature-request.yaml&title=%5Bfeature%5D%3A+).
|
||
- Review the [documentation](https://docs.plane.so/) and submit [pull requests](https://github.com/makeplane/docs) to improve it—whether it's fixing typos or adding new content.
|
||
- Talk or write about Plane or any other ecosystem integration and [let us know](https://discord.com/invite/A92xrEGCge)!
|
||
- Show your support by upvoting [popular feature requests](https://github.com/makeplane/plane/issues).
|
||
|
||
Please read [CONTRIBUTING.md](https://github.com/makeplane/plane/blob/master/CONTRIBUTING.md) for details on the process for submitting pull requests to us.
|
||
|
||
### Repo activity
|
||
|
||
|
||
|
||
### We couldn't have done this without you.
|
||
|
||
<a href="https://github.com/makeplane/plane/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=makeplane/plane" />
|
||
</a>
|
||
|
||
|
||
## License
|
||
This project is licensed under the [GNU Affero General Public License v3.0](https://github.com/makeplane/plane/blob/master/LICENSE.txt).
|