This is an SSR CMS built with AstroDB / Lucia Auth / Unpic Image handler 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.
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.
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.
If you'd like to contribute code to this project, please follow these steps:
- Fork the repository and create a new branch for your contribution.
- Make your changes and ensure that the code follows our coding conventions and style guidelines.
- Write tests for your changes, if applicable.
- Update the documentation, if necessary.
- Commit your changes and push them to your forked repository.
- Open a pull request against the main repository, providing a clear description of your changes and their purpose.
We will review your contribution as soon as possible and provide feedback or merge it into the main codebase if everything looks good.
Please note that by contributing to this project, you agree to our Code of Conduct.
Thank you for your interest in contributing to this project!
We have an active community of developers on the Astrolicious Discord Server. Feel free to join and connect with other contributors, ask questions, or discuss ideas related to this project or other Astrolicious projects.
This is a Moonrepo
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
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 totrue
-
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:login
- Login your CLI to Astro Studiopnpm playground:link
- Link to Astro Studio and Create a new DB for your CMS Installationpnpm playground:push
- Creates the base tables on the remote database.pnpm playground:dev
- Starts the Dev server connected to the linked database
Once that process completes successfuly you are ready to navigate to http:https://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 i 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