Skip to content

withstudiocms/studiocms

Repository files navigation

StudioCMS

Readme's Banner

NPM Version Formatted with Biome Built with Astro

This is an SSR CMS built with AstroDB for the Astro Ecosystem.

To see how to get started, check out the StudioCMS README.

Important

This project is still in early development and it is not yet ready for production use. If you encounter any issues or have ideas for new features, please let us know by opening an issue on our GitHub repository.

Sponsor

StudioCMS Dashboard i18n Status

Translation status

Contributing

We welcome contributions from the community! Whether it's bug reports, feature requests, or code contributions, we appreciate your help in making this project better.

Bug Reports and Feature Requests

If you encounter any bugs or have ideas for new features, please open an issue on our GitHub repository. When creating a new issue, please provide as much detail as possible, including steps to reproduce the issue (for bugs) and a clear description of the proposed feature.

Code Contributions

We welcome contributions from the community! Whether it's bug reports, feature requests, or code contributions, we appreciate your help in making this project better. To get started read our Contributing Guide

Please note that by contributing to this project, you agree to our Code of Conduct.

Chat with Us

We have an active community of developers on the StudioCMS Discord Server. Feel free to join and connect with other contributors, ask questions, or discuss ideas related to this project or other StudioCMS projects.

Our ToolSet

For an up-to-date list of our main tools check out our .prototools file

For more information about Proto checkout Proto's Website

This is a Moon repository

Follow install instructions listed on Moonrepo's docs, and you'll be all set to go! Its even a super easy single line command you put in your terminal!

To use the dev server the command is moon run playground:dev

Note: You can always fallback to standard pnpm, Please ensure your version matches our project, and run pnpm i --frozen-lockfile to install deps

How to use the playgrounds

At the moment these are the current steps for setting up the main StudioCMS playground.

This is intended for testing and development, since we have not yet released a package to play with use these instruction at your own risk This project is still very experimental

The primary playground is the Node Playground

Steps to get a running playground should be the following:

  • clone repo

  • run pnpm i --frozen-lockfile

  • change dbStartPage in the node playground's config to true

  • read the first time setup instructions listed in the main package readme then replace the astro db commands with the following:

    Commands to run:

    • pnpm playground:push - Push to your libSQL database assigned via environment variables
    • pnpm playground:dev - Starts the Dev server connected to the linked database

Once that process completes successfully you are ready to navigate to http://localhost:4321/start and follow the instructions to get started.

It will redirect and ask you to shutdown and change the above mentioned config option dbStartPage to false at which point that will enable full functionality of the CMS. you can now restart the dev server with astro dev --remote to continue viewing your new site!

That will give you a running dev environment of what we work with daily... the only other thing to get the full functionality currently is to configure a gitub oAuth app for the Dashboard and authentication

To start the playground again use the command pnpm playground:dev

Licensing

MIT Licensed.