Skip to content

Commit

Permalink
Merge pull request #119 from osh0612/feature/contributing-md
Browse files Browse the repository at this point in the history
core: update readme
  • Loading branch information
SkidGod4444 authored Dec 22, 2024
2 parents 383a2f0 + ef69737 commit fc9971c
Show file tree
Hide file tree
Showing 4 changed files with 80 additions and 102 deletions.
61 changes: 24 additions & 37 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
![Plura Logo](/apps/www/public/images/plura-logo.png)

# Contributing

When contributing to this repository, please first discuss the change you wish to make via issue,
email, or any other method with the owners of this repository before making a change.
When contributing to this repository, please first search through the issues in the repository and commit "assign me" if you wish to work on that ,
then owners of this repository will let you know by latest by assigning you the issue.

Please note we have a code of conduct, please follow it in all your interactions with the project.

Expand Down Expand Up @@ -35,47 +37,32 @@ Please note we have a code of conduct, please follow it in all your interactions
4. You may merge the Pull Request in once you have the sign-off of two other developers, or if you
do not have permission to do that, you may request the second reviewer to merge it for you.

## Code of Conduct

### Our Pledge

In the interest of fostering an open and welcoming environment, we as
contributors and maintainers pledge to making participation in our project and
our community a harassment-free experience for everyone, regardless of age, body
size, disability, ethnicity, gender identity and expression, level of experience,
nationality, personal appearance, race, religion, or sexual identity and
orientation.

### Our Standards

Examples of behavior that contributes to creating a positive environment
include:

* Using welcoming and inclusive language
* Being respectful of differing viewpoints and experiences
* Gracefully accepting constructive criticism
* Focusing on what is best for the community
* Showing empathy towards other community members

Examples of unacceptable behavior by participants include:

* The use of sexualized language or imagery and unwelcome sexual attention or
advances
* Trolling, insulting/derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information, such as a physical or electronic
address, without explicit permission
* Other conduct which could reasonably be considered inappropriate in a
professional setting

### Our Responsibilities

Project maintainers are responsible for clarifying the standards of acceptable
behavior and are expected to take appropriate and fair corrective action in
response to any instances of unacceptable behavior.
Project maintainers are responsible for:
- Providing guidance to contributors
- Maintaining repository quality and standards
- Setting clear expectations for contributions

Contributors are expected to follow maintainer guidance and project guidelines.

Project maintainers have the right and responsibility to remove, edit, or
reject comments, commits, code, wiki edits, issues, and other contributions
that are not aligned to this Code of Conduct, or to ban temporarily or
permanently any contributor for other behaviors that they deem inappropriate,
threatening, offensive, or harmful.

## 📞 Contact

- Project Link: [GitHub Repository](https://github.com/Skidgod4444/plura)
- Discord: [Discord](https://discord.gg/plura)
---

### Contributing

<a href="https://github.com/SkidGod4444/plura/graphs/contributors">
<img src="https://contrib.rocks/image?repo=SkidGod4444/plura" />
</a>

**Engineered with ❤️ by the Plura Team**
92 changes: 32 additions & 60 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,81 +1,53 @@
# Turborepo starter
# Plura

This is an official starter Turborepo.
![Plura Logo](/apps/www/public/images/plura-logo.png)

## Using this example
## 👀 What is this?

Run the following command:
Plura is a SaaS platform that redefines AI-powered communication and interaction. Our innovative solution allows you to create intelligent "brains" - custom AI agents that can be trained with specific information and connected across multiple communication channels.

```sh
npx create-turbo@latest
```
### 🫣Whats inside?
Coming soon

## What's inside?
## 🔑 Key Features
- 🔗**Multi-Channel Connectivity**: Connect agents to websites, WhatsApp, Discord, and more
- 🧠**Custom AI Training**: Easily teach your AI agents with specific, information
- 💬 **Chat with Collections**: Interact with specific knowledge bases.
- 🏠 **Self Hostable**: Open source and easy to deploy locally.

This Turborepo includes the following packages/apps:

### Apps and Packages
## 🏗 System Architecture

- `docs`: a [Next.js](https://nextjs.org/) app
- `web`: another [Next.js](https://nextjs.org/) app
- `@repo/ui`: a stub React component library shared by both `web` and `docs` applications
- `@repo/eslint-config`: `eslint` configurations (includes `eslint-config-next` and `eslint-config-prettier`)
- `@repo/typescript-config`: `tsconfig.json`s used throughout the monorepo
Coming soon

Each package/app is 100% [TypeScript](https://www.typescriptlang.org/).
## 💻 Tech Stack

### Utilities
Coming soon

This Turborepo has some additional tools already setup for you:
## 🤝 Contributing
Contributions are very welcome! A contribution can be as small as a ⭐ or even finding and creating issues.

- [TypeScript](https://www.typescriptlang.org/) for static type checking
- [ESLint](https://eslint.org/) for code linting
- [Prettier](https://prettier.io) for code formatting
- for joining our community, please Contact [Saidev Dhal](https://cal.com/saidevdhal)
- for contributing to our code, please follow the contribution guidelines below

### Build
### Contribution Guidelines
- Go check out [Contributing.md](https://github.com/SkidGod4444/plura/blob/main/CONTRIBUTING.md)

To build all apps and packages, run the following command:

```
cd my-turborepo
pnpm build
```
## 📄 Licensing

### Develop
Distributed under the MIT License.

To develop all apps and packages, run the following command:
## 📞 Contact

```
cd my-turborepo
pnpm dev
```
- Mail: [[email protected]](mailto:[email protected])
- Discord: [Discord](https://l.devwtf.in/plura-dc)
---

### Remote Caching
### Contributing

Turborepo can use a technique known as [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.
<a href="https://github.com/SkidGod4444/plura/graphs/contributors">
<img src="https://contrib.rocks/image?repo=SkidGod4444/plura" />
</a>

By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can [create one](https://vercel.com/signup), then enter the following commands:

```
cd my-turborepo
npx turbo login
```

This will authenticate the Turborepo CLI with your [Vercel account](https://vercel.com/docs/concepts/personal-accounts/overview).

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your Turborepo:

```
npx turbo link
```

## Useful Links

Learn more about the power of Turborepo:

- [Tasks](https://turbo.build/repo/docs/core-concepts/monorepos/running-tasks)
- [Caching](https://turbo.build/repo/docs/core-concepts/caching)
- [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching)
- [Filtering](https://turbo.build/repo/docs/core-concepts/monorepos/filtering)
- [Configuration Options](https://turbo.build/repo/docs/reference/configuration)
- [CLI Usage](https://turbo.build/repo/docs/reference/command-line-reference)
**Engineered with ❤️ by the Plura Team**
14 changes: 12 additions & 2 deletions apps/api/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,16 @@ UPSTASH_REDIS_REST_TOKEN=
UPSTASH_REDIS_REST_URL=
```

## License
## 📞 Contact

Copyright 2024 Plura.
- Project Link: [GitHub Repository](https://github.com/Skidgod4444/plura)
- Discord: [Discord](https://discord.gg/plura)
---

### Contributing

<a href="https://github.com/SkidGod4444/plura/graphs/contributors">
<img src="https://contrib.rocks/image?repo=SkidGod4444/plura" />
</a>

**Engineered with ❤️ by the Plura Team**
15 changes: 12 additions & 3 deletions apps/www/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,17 @@ To set up your environment for the project, follow these steps:

- Access your application at [Upastash](http://localhost:3001/api/health).

## Need Help?
## 📞 Contact

- Check our [Contributing Guide](../../CONTRIBUTING.md)
- Join our [Discord Community](https://discord.gg/XtybuwJV)
- Project Link: [GitHub Repository](https://github.com/Skidgod4444/plura)
- Discord: [Discord](https://discord.gg/plura)
---

### Contributing

<a href="https://github.com/SkidGod4444/plura/graphs/contributors">
<img src="https://contrib.rocks/image?repo=SkidGod4444/plura" />
</a>

**Engineered with ❤️ by the Plura Team**

0 comments on commit fc9971c

Please sign in to comment.