palmares

A Javascript and Typescript framework aimed at unification.

MIT License

Downloads
26.9K
Stars
31

Description

Palmares is a framework that aims for unification and freedom. It's opinionated at the same time it's not. Bring your own tools, forget thinking if X works with Y. With Palmares it just works! You can use it even without a server!

It's aimed to work well on monorepos and have ZERO dependencies at it's core. You should be able to use it with most available runtimes.

Motivation

The name of this framework is a tribute to Zumbi dos Palmares, a Brazilian hero who fought against the portuguese for the freedom of slaves in Brazil. A Quilombo was a place were the people who scaped slavery could go to live free in a community. This framework aims not to be yet another replacement tool or framework, but a framework that unify all JS ecosystem into one. It's about union and freedom of choosing what you want to use.

Every single day a hole bunch of time needs to be spent dealing with the complexity of making libraries work together. You just spent 3 full weeks trying to make your ORM work with your schema validator, guess what? Seems that a new ORM solution just came out yesterday.

With Palmares we can unify all the ecosystem into one by worrying in 2 fronts:

  • How to make the framework easy to use
  • How to make the framework easy to extend

Getting Started and Documentation

Coming soon...

Issues

Guarantee that your issue follow our code of conduct guidelines before posting. All issues that does not follow our Code of Conduct will be closed and ignored.

Discussions and Help

Use our discussions tab for help and questions. We will be glad to help you out.

F.A.Q.

  • Cool project!: Thank you.
  • Can I use it with typescript?: Yes, you can.
  • Where did you got the inspiration?: From Django and Rails, mostly. But they have lots of stuff, i want to make a more open and customizable version where you can use the tools you already use and love.
  • Can I contribute?: Yes, please do. We will be glad to have you on board.
  • Can I use it in production?: Not yet, we are still in early development.
  • Can I use it in my company?: Yes, you will be promoted if you use it.
  • Does it work with X?: Hopefully yes, if not, please open an issue.
  • Can I use it with my favorite ORM?: Yes, you can use it with any ORM you want.
  • Does it support the Edge?: Sadly it does not support edging at this given moment.
  • REWRITE IN RUST!!!: Yes, you can create adapters in rust, it's one of my ideas.
  • Don't you care about performance?: Yes, we do, but we care more about you having more time to spend with your family (Developer Experience)
  • When will it be ready?: When it's ready.
  • EW, JS, WHY NOT JAVA?: But it's Java.
  • I don't like it: I'm sorry to hear that, but you'll need to live and deal with our existence.
  • I love it: Thank you, we love you too.