Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meldiron/appwrite-cms-v0

Prepare admin panels for your projects rapidly using AppwriteCMS, a headless CMS for your Appwrite project.
https://github.com/meldiron/appwrite-cms-v0

appwrite nuxt nuxtjs vue

Last synced: 1 day ago
JSON representation

Prepare admin panels for your projects rapidly using AppwriteCMS, a headless CMS for your Appwrite project.

Awesome Lists containing this project

README

        

![Cover image](/static/cover.png)

_Documentation is hosted on [GitBook](https://meldiron-appwrite.gitbook.io/appwrite-cms/). Please refer to this website when looking for any guides._

# AppwriteCMS

Hey there πŸ‘‹

Happy to see you here... Since you are looking for Appwrite admin panel, you already know what Appwrite is, right... Right?!?!

If you never heard about Appwrite, please check out their [Website](https://appwrite.io/) to learn more about this amazing backend as a service. Believe it or not, you can't use AppwriteCMS without Appwrite 😬

With that said...

Prepare admin panels for your projects rapidly using AppwriteCMS, a headless CMS for your Appwrite project.

AppwriteCMS is headless CMS for your Appwrite database. Appwrite allows you to manage your database and files, but the UI is too developer-ish and allows zero customization. In the end, it is a tool for developer not copywriter, so noone ever expected to use Appwrite as CMS. That's where AppwriteCMS comes into play! Connect AppwriteCMS to your Appwrite project and configure it as much as you need. AppwriteCMS also allows you to write your own components to achieve any interface your project needs. You can learn more in our [official documentation](https://meldiron-appwrite.gitbook.io/appwrite-cms/).

Oh, I almost forgot...

I never liked when people miss-spell my name from Matej to MadΕΎejč. Products feel the same! πŸ€– Let's not offend them, okay?

The correct spelling is `Appwrite`, not `AppWrite`. Just like that, this is product is called `AppwriteCMS`, not `Apppwrite CMS`, and absolutely not `ApVrajt CMS`.

Thanks for your attention open source community! See you later in GitHub issues section πŸ‘‹

## Documentation

You can find bunch of resources in our official [GitBook](https://meldiron-appwrite.gitbook.io/appwrite-cms/) documentation.

## Contributing

Fun fact, we are using Nuxt! πŸ₯³ If you understand Vue, you are more than ready to start building components. If you don't, eh, you will figure it out πŸ˜… Don't be scared, components are tiny HTML, CSS and JS snippets that only uses Vue to bind data between HTML an JavaScript. To see quick example, you can take a look at our [FormTextareaInput](https://github.com/Meldiron/appwrite-cms/blob/master/components/blocks/form/TextareaInput.vue).

All code external contributions must go through a pull request and be approved by a core developer team before being merged. This flow ensures a proper review of all the code and increases the quality of the product.

We truly ❀️ pull requests! Refer to information below and our [Contributing Guide](https://github.com/Meldiron/appwrite-cms/blob/master/CONTRIBUTING.md) in order to understand how to setup AppwriteCMS, build the project and see how folder structore works.

## Build Setup

```bash
# install dependencies
$ yarn install

# serve with hot reload at localhost:3000
$ yarn dev

# build for production and launch server
$ yarn build
$ yarn start

# generate static project
$ yarn generate
```

For detailed explanation on how things work, check out the [documentation](https://nuxtjs.org).

### Special Directories

You can create the following extra directories, some of which have special behaviors. Only `pages` is required; you can delete them if you don't want to use their functionality.

#### `assets`

The assets directory contains your uncompiled assets such as Stylus or Sass files, images, or fonts.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/assets).

#### `components`

The components directory contains your Vue.js components. Components make up the different parts of your page and can be reused and imported into your pages, layouts and even other components.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/components).

#### `layouts`

Layouts are a great help when you want to change the look and feel of your Nuxt app, whether you want to include a sidebar or have distinct layouts for mobile and desktop.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/layouts).

#### `pages`

This directory contains your application views and routes. Nuxt will read all the `*.vue` files inside this directory and setup Vue Router automatically.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/get-started/routing).

#### `plugins`

The plugins directory contains JavaScript plugins that you want to run before instantiating the root Vue.js Application. This is the place to add Vue plugins and to inject functions or constants. Every time you need to use `Vue.use()`, you should create a file in `plugins/` and add its path to plugins in `nuxt.config.js`.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/plugins).

#### `static`

This directory contains your static files. Each file inside this directory is mapped to `/`.

Example: `/static/robots.txt` is mapped as `/robots.txt`.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/static).

#### `store`

This directory contains your Vuex store files. Creating a file in this directory automatically activates Vuex.

More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/store).