Skip to content

Commit

Permalink
Merge branch 'release/4.0.0-alpha.10'
Browse files Browse the repository at this point in the history
  • Loading branch information
brunobuddy committed Aug 8, 2024
2 parents 83fd16d + 017504e commit 06de45c
Show file tree
Hide file tree
Showing 9 changed files with 140 additions and 191 deletions.
72 changes: 72 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Contributing to Manifest

Thank you for taking the time to contribute to Manifest! 🫶 🎉

Manifest aims to simplify backend development. We want to make backends simple and fun, allowing more people to create and share their own tools.

Manifest is an Open Source project hosted under the [Manifest organization on GitHub](https://github.com/mnfst)

## How can I contribute?

There are several ways to contribute to Manifest other than developing:

- 🐛 Report a bug using [GitHub issues](https://github.com/mnfst/manifest/issues/new?assignees=SebConejo&labels=bug&projects=&template=%F0%9F%90%9B-bug-report.md&title=)
- ✨ Suggest an enhancement using [GitHub discussions](https://github.com/mnfst/manifest/discussions/new?category=feature-request)
- 🪶 Correct or improve the doc in its [own repository](https://github.com/mnfst/docs/issues/new)

Otherwise, you also can offer your help by talking to a team member on our [Discord](https://discord.com/invite/FepAked3W7) 🤗.

## Packages and repositories

Before coding it is important to understand where the functionality you want to change is located.

Manifest is a set of several packages and [repositories](https://github.com/orgs/mnfst/repositories) built with open source software, using TypeScript as the main language.

| Name | Description | Stack | Repo | Package |
| -------------- | ------------------------------------------ | -------------------------- | --------------------------------------------- | ---------------------------------------------------------- |
| Manifest | Manifest core | NestJS / Express / TypeORM | [manifest](https://github.com/mnfst/manifest) | [manifest](https://www.npmjs.com/package/manifest) |
| Manifest Admin | Official Admin Panel | Angular | [manifest](https://github.com/mnfst/manifest) | [@mnfst/admin](https://www.npmjs.com/package/@mnfst/admin) |
| Manifest Types | Utility types | TypeScript | [manifest](https://github.com/mnfst/manifest) | [@mnfst/types](https://www.npmjs.com/package/@mnfst/types) |
| Add Manifest | NPX install script | OCLIF | [manifest](https://github.com/mnfst/manifest) | [add-manifest](https://www.npmjs.com/package/add-manifest) |
| JS SDK | JavaScript SDK | TypeScript | [js-sdk](https://github.com/mnfst/js-sdk) | [@mnfst/sdk](https://www.npmjs.com/package/@mnfst/sdk) |
| Website | Official website: https://manifest.build | NextJS | [website](https://github.com/mnfst/website) | - |
| Docs | Documentation: https://manifest.build/docs | Markdown / Docusaurus | [docs](https://github.com/mnfst/docs) | - |

## Development workflow and guidelines

### Prerequisites

- You are familiar with Git (issues and PR)
- You have read the [docs](https://manifest.build/docs)
- You have looked at the [Code of Conduct](https://github.com/mnfst/manifest/blob/master/CODE_OF_CONDUCT.md) and [MIT License](https://github.com/mnfst/manifest/blob/master/LICENSE)

### Before you start

- Manifest is built on the concept of simplicity, contributions should go in that direction
- Each PR is linted with Prettier, and code quality is checked with CodeFactor
- Commit labels should be made using the [Conventional Commits convention](https://www.conventionalcommits.org/en/v1.0.0/)
- Please create only one thing per pull request as it is easier to validate and merge

### Workflow

1. Make sure that there is an [existing issue](https://github.com/mnfst/manifest/issues) for what you will be working on. If not, [create one](https://github.com/mnfst/manifest/issues/new) as this ensures that others can contribute with thoughts or suggest alternatives
2. When ready, fork the correct repository and branch out from the `develop` branch (or `master` for a hotfix)
3. Make your changes
4. Open a [Pull Request from your fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)
5. The core team will review it soon, ask for feedback, and eventually merge it

### Branches

There are 2 main branches:

- `master`: production version
- `develop`: development branch

When contributing, please follow this branch naming convention:

- `feature/x` branches add new features and the PR should be done to the `develop` branch
- `hotfix/x` branches create a hotfix and the PR should be done to the `master` branch

This rule applies to all repositories.

**Happy coding!** 🤗
15 changes: 15 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,21 @@ Simply run this terminal command to add Manifest:
npx add-manifest
```

## Product roadmap
Our mission is to enable developers of all experience levels to create and share innovative solutions. As an **open source** product, we continuously improve Manifest through community collaboration. After our successful PoC, we are further developing the product with your feedback. Here are the upcoming features:

| Feature | Description | Release date | Status |
| --- | --- | --- | --- |
| **OpenAPI Doc** | Instant live documentation for your REST API | July 2024 | ✅ Available |
| **Auth** | Make any entity authenticatable and add rules for endpoints | August 2024 | 🚧 In progress |
| **Validation** | Custom validation for creating and updating items | Q3 2024 | 📝 To specify |
| **Many-to-many** | Advanced relationship management | Q4 2024 | 📝 To specify |
| **Hooks** | Trigger webhooks at specific events | Q4 2024 | 📝 To specify |
| **Media upload** | Allow file and image uploads with rules and resizing | Q4 2024 | 📝 To specify |

🆕 [Suggest a new feature for the next versions](https://github.com/mnfst/manifest/discussions/new?category=feature-request)


## Community & Resources

- [Docs](https://manifest.build/docs) - Get started with Manifest
Expand Down
2 changes: 1 addition & 1 deletion packages/add-manifest/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "add-manifest",
"version": "0.1.0-alpha.5",
"version": "0.1.0-alpha.6",
"author": "Manifest",
"description": "Add Manifest backend to your app",
"homepage": "https://manifest.build",
Expand Down
2 changes: 1 addition & 1 deletion packages/add-manifest/src/commands/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ export class MyCommand extends Command {
updatePackageJsonFile({
fileContent: packageJson,
newPackages: {
manifest: '^4.0.0-alpha.8'
manifest: '^4.0.0-alpha.10'
},
newScripts: {
manifest: 'node node_modules/manifest/scripts/watch/watch.js',
Expand Down
49 changes: 14 additions & 35 deletions packages/core/admin/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 06de45c

Please sign in to comment.