https://github.com/amelioro/ameliorate
A tool for collaboratively refining your understanding in order to improve a situation.
https://github.com/amelioro/ameliorate
critical-thinking hacktoberfest material-ui nextjs react react-flow reactjs tailwindcss tools-for-thought typescript zustand
Last synced: about 1 month ago
JSON representation
A tool for collaboratively refining your understanding in order to improve a situation.
- Host: GitHub
- URL: https://github.com/amelioro/ameliorate
- Owner: amelioro
- License: mit
- Created: 2022-06-28T01:26:35.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-06T14:54:48.000Z (about 1 month ago)
- Last Synced: 2025-05-07T03:08:24.018Z (about 1 month ago)
- Topics: critical-thinking, hacktoberfest, material-ui, nextjs, react, react-flow, reactjs, tailwindcss, tools-for-thought, typescript, zustand
- Language: TypeScript
- Homepage: https://ameliorate.app
- Size: 13.8 MB
- Stars: 67
- Watchers: 6
- Forks: 22
- Open Issues: 113
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Ameliorate
[](https://github.com/amelioro/ameliorate/blob/main/LICENSE) [](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md) [](#contributors-) [](https://discord.gg/3KhdyJkTWT)
[Ameliorate](https://www.ameliorate.app/) is a tool for refining your understanding of a situation, so that you can make better decisions about it.
It proposes [a way of breaking down problems](https://ameliorate.app/#break-things-down) that's particularly built for collaborative refinement, and provides [tooling](https://ameliorate.app/#features) for navigating and working with that information.
Check out:
- the [homepage](https://www.ameliorate.app/), which showcases what the app does and some cool features
- the in-app tutorials (go to the app via [Start Building](https://ameliorate.app/new) or [Play Around](https://ameliorate.app/playground)), which show you how to use the tool
- the [docs](https://www.ameliorate.app/docs) for further details about the app (most likely to be slightly out-of-date)
## Roadmap
Check out the [GitHub Project](https://github.com/orgs/amelioro/projects/2/views/1) for an organized, prioritized list of issues.
## Built with
Full-stack:
- [typescript](https://www.typescriptlang.org/)
- [nextjs](https://nextjs.org/) - web framework
- [zod](https://github.com/colinhacks/zod) - runtime json schema validation
- [netlify](https://netlify.com/) - deploying web & api server
- [auth0](https://auth0.com/) - user authentication
- [sentry](https://sentry.io/) - monitoring, observability
- [vitest](https://vitest.dev/) - api & unit testing
- [playwright](https://playwright.dev/) - e2e testing
Backend:
- [prisma](https://www.prisma.io/) - database querying & schema management
- [neon](https://neon.tech) - hosting managed database
- [trpc](https://trpc.io/) - type-safe endpoints
Frontend:
- [react](https://reactjs.org/) - building components
- [react flow](https://reactflow.dev/) - diagram component
- [zustand](https://github.com/pmndrs/zustand) - component state management
- [tailwind](https://tailwindcss.com/) - styling (deprecating [emotion](https://emotion.sh/docs/introduction))
- [material ui](https://mui.com/) - theming, component library
- [react query](https://react-query.tanstack.com/) - querying api
- [react hook form](https://react-hook-form.com/) - form validation
## Contributing
Feel free to start discussion or ask questions in the [Discord server](https://discord.gg/3KhdyJkTWT).
Use GitHub's [issues](https://github.com/amelioro/ameliorate/issues) to submit a [bug report](https://github.com/amelioro/ameliorate/issues/new?assignees=&labels=bug%2Cneeds+review&projects=&template=bug_report.yml), [feature request](https://github.com/amelioro/ameliorate/issues/new?assignees=&labels=enhancement%2Cneeds+review&projects=&template=feature_request.yml), or any other [idea/question](https://github.com/amelioro/ameliorate/issues/new?assignees=&labels=needs+review&projects=&template=other-issues.md&title=) you've got.
See the [Contributor's Guide](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md) for
- [Code of Conduct](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#code-of-conduct)
- [Providing feedback](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#providing-feedback)
- [Finding an issue to work on](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#finding-an-issue-to-work-on)
- [Running the project](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#running-the-project)
- [Codebase overview](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#codebase-overview)
- [Working with the code](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#working-with-the-code)
- [PR process](https://github.com/amelioro/ameliorate/blob/main/CONTRIBUTING.md#pr-process)
## Contributors ✨
Thanks go to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Joel Keyser
💻 🎨 🤔 💬 👀
CatGuardian
🎨 📆 🤔
Alex Tilot
️️️️♿️ 💻 🎨
Amelia Dutta
💻
Hanson Sin
💻
Tarun Samanta
💻
Adrian
💻
Sean Yeh
💻
Shiv Shankar
💻
Roy Badell
💻 🎨
IAmPrem7685
💻
mdiv.io
💻
lovelypangotra2003
💻
This project follows the [all-contributors](https://allcontributors.org) specification.
Contributions of any kind are welcome!
## License
[MIT](https://github.com/amelioro/ameliorate/blob/main/LICENSE)