Skip to content
forked from arduosoft/RawCMS

RawCMS is the headless CMS written in asp.net core build for developers that embrace API first technology. You can join the project by filling this

License

Notifications You must be signed in to change notification settings

zeppaman/RawCMS

 
 

Repository files navigation

RawCMS is a headless CMS written in ASP.NET Core, built for developers that embrace API-first technology. RawCMS uses MongoDB as its data storage and is ready to be hosted on Docker containers.

CodeFactor Build status Tweet Join the chat at https://gitter.im/arduosoft/RawCMS-Headless-CMS-Aspnet

Contribution

As every open source project, we are looking for contributors. Any kind of help is welcome. Just a star on the project is a lot. If you want to contribute as a developer, you can join the project by filling out this form or by opening an issue. Any other kind of contribution, from docs to tests, is also welcome.

Try it

You can test RawCMS using the public demo using the default credentials (username:bob, password:XYZ).

Deploy it

You can deploy it using many options. RawCMS is dockerized from the development stage so modern hosting is fully supported.

  1. Docker Compose using the provided docker-compose file
  2. Kubernetes using the provided docker images
  3. Heroku using the provided images
  4. Virtual machines using the packages provided and deployed manually to the server

The mission of RawCMS

  1. Modular: Each module is shipped in a NuGet package that can be added to the system to gain new features
  2. Headless: RawCMS doesn't include any presentation logic. All presentation is delegated to the caller. This aims to create a scalable and reusable system
  3. Packaged: RawCMS must be shipped into a single deployable package or added into an existent ASP.NET Core application as a NuGet package.
  4. Extensible: RawCMS must be customized by the user through extension only. So no changes to the code will be done, just adding new packages.
  5. Buildless: RawCMS must give the possibility to manage an installation without the need to manage a codebase or a code repository. It will be possible to add lambdas code at runtime.
  6. Caller Friendly: Produce data in many formats to help integration (Odata, GraphQL)

If you are interested in contributing just open an issue to start a conversation. Help wanted.

Run

You have 3 options to start using RawCMS:

  • Run a docker instance using docker pull arduosoft/rawcms-preview or see dockerhub page to get more options like docker-compose file.
  • Download the zip and deploy a regular ASP.NET core application from GitHub releases
  • Fork the repository and customize (then deploy as you want)

Technical documentation

You can find all we have on GitHub wiki. There is documentation for users, developers, and contributors.

Features

  • Store and filter any data using MongoDB expression
  • Docker container ready
  • Data validation
  • Possibility to add business logic on the backend
  • Authentication against external Oauth2 server
  • Provide Oauth2 tokens and store users into local DB
  • Possibility to create a custom endpoint
  • Upsert and incremental update
  • GraphQL data query

LIMITATIONS

  • CRUD controller must manage exceptions and errors
  • No UI to manage entities
  • No data data relation

ROADMAP

PHASE 1 - POC

  • Dynamic entity management
  • Expose with regular web API services and Swagger
  • Lambda
  • Schema definition and validation

PHASE 2 - Be ready for production

  • Expose with GraphQL
  • Authentication and permission
  • Lambda HTTP
  • Plugin system
  • Client to automate operations

PHASE 3 - Ready to send on a rocket to Mars

  • Expose with Odata
  • Test and client sample
  • design UI for schema management
  • design UI for data management

License

This software is published under the GNU General Public License v3.

About

RawCMS is the headless CMS written in asp.net core build for developers that embrace API first technology. You can join the project by filling this

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 70.4%
  • JavaScript 21.5%
  • HTML 7.0%
  • Shell 0.6%
  • CSS 0.3%
  • Dockerfile 0.2%