Strapi

Overview

The EOS Strapi application is a repository that serves as a dependency to run the User Story. It includes all the necessary models and routes to manage either project independently or both at the same time, using the same Strapi. It provides a user interface to manage feature requests for EOS Feature Request and also manages the table of contents and general project configuration for the EOS Design System.

Features

• Dependency to run the User Story
• Models and routes for managing projects independently or together
• User interface for managing feature requests
• Manages table of contents and project configuration for the EOS Design System

Locally

1. Clone the EOS Strapi repository and navigate to its folder.
2. Install all the dependencies by running npm i.
3. Configure and enable CORS middleware by adding your client or origin URL in ./config/middleware.js. Duplicate the file .env.example and rename it as .env, then add your domains to the EOS_CORS_DOMAINS variable list.
4. Connect to a database by modifying the variables in the .env file. Make sure you have a DB running before starting the project. Recommended databases are Mongo Atlas or Mlab, both of which offer a free tier with up to 500mb of storage.
5. Start the project by running npm start. It will serve a page at http://localhost:1337/admin where you can create your first admin user.

Using Docker

1. Make sure you have Docker installed. Refer to the Docker documentation for installation instructions.
2. Run docker-compose up to start the container. Add the -d flag to run it in detached mode.
3. Stop the container either from the Docker UI or by using CTRL + C in your terminal.
4. Create a new user for your Strapi at http://localhost:1337/admin/auth/.
5. Grant read/write permissions by going to Roles & Permissions > Public and selecting all permissions for Applications, Pages, and Successes (or any others needed).
6. If you make any changes to Strapi (e.g., new content, file changes), you will need to rebuild the image.
   • Run docker-compose down.
   • Run docker-compose build to build the image from cache.
   • Run docker-compose up to start the updated application.

Summary

The EOS Strapi application is a versatile repository that provides the necessary tools and infrastructure to run the User Story. It allows for independent project management or simultaneous management of multiple projects using the same Strapi. The application includes features such as a user interface for managing feature requests and configuration options for the EOS Design System. Installation can be done locally or using Docker, and the application supports GraphQL for making API calls.