SaaS that is hosted on the cloud and built by community. To make developer life easy.
.webp
format;So basically it's a simple CMS that would work best for representative simple business sites.
In chemistry, isomers are molecules or polyatomic ions with identical molecular formulae – that is, same number of atoms of each element – but distinct arrangements of atoms in space. Isomerism is existence or possibility of isomers. Isomers do not necessarily share similar chemical or physical properties.
Similar in WEB developers life - if you deal with simple representative websites, preparation for each is more or less identical to all other. You need admin panel, you need to host is somewhere, you need database for admin panel, you need to host website itself and so on. Most boring, repetitive part seems to be Admin part so it was decided to build this headless CMS to allow way faster bootstrapping!
Everything we build get's to production! 🔥💪 We, the contributors community, build our own SaaS the way we want to have it!
Since it's just a beginning, you might not find these sites very useful 😅 Yet. But we are moving forward!
🚀 https://www.figma.com/file/h4TW7xZmZtsCikldbx9HVj/Isomera-Roadmap
Any kind of contributions are welcome! Feel free to open a PR with your changes ♥️
Please read our Contributing Guide before submitting a Pull Request to the project.
Install Isomera with this Quickstart command to create a Isomera project instantly:
docker-compose up -d
yarn install
cp .env.example .env
yarn dev
This command generates a brand new project with the default features (authentication, permissions, content management, content type builder & file upload).
Enjoy 🎉
Locally it will use SQLite database so it would be easier to develop and test. For production, it is originally intended to be used with PostgreSQL. It uses TypeORM so it's quite easy to adapt to any other database.
Project is managed by NX - next generation build system with first class monorepo support and powerful integrations. Documentation can be found here https://nx.dev/getting-started/intro
Before any commit, make sure that your code is well linted, pretty and well formatted. The following commands can help you do that automatically:
npx nx format:write
yarn prettier:fix
Also, turn on Prettier on save.
You can check if everything is ok by running these commands:
npx nx format
yarn prettier
yarn lint
🚀 GraphQL http://localhost:3000/graphql
🚀 Swagger http://localhost:3000/swagger
For nicer visualisation we're using Material UI Devias Kit - React Admin Dashboard free version.
If you're contributing, please download this template and extract parts needed and use it here. Let's not deviate too much.
Complete installation requirements can be found in the documentation... TBD
Supported operating systems:
(Please note that Isomera may work on other operating systems, but these are not tested nor officially supported at this time.)
Node:
Database:
Database | Minimum | Recommended |
---|---|---|
MySQL | 5.7.8 | 8.0 |
MariaDB | 10.3 | 10.6 |
PostgreSQL | 11.0 | 14.0 |
SQLite | 3 | 3 |
We recommend always using the latest version of Isomera to start your new projects.
We are working with TypeOrm and nx monorepo. We've made useful queries to run its CLI commands, the queries are described in apps/api/project.json, so far, we have:
Please read our Contributing Guide before submitting a Pull Request to the project.
For general help using Isomera, please refer to the official Isomera documentation. For additional help, you can use one of these channels to ask a question:
See the LICENSE file for licensing information.