This project uses Strapi as a CMS backend.

If you'd like to develop locally, follow these steps. Otherwise, you can skip to Gitpod development below.

git clone [email protected]:distributeaid/aggregated-public-information.git
cd aggregated-public-information

To develop or contribute to this project, you will need Node.js. We recommend you install Node Version Manager (nvm) to manage Node.js versions.

To build dependencies, you should also have yarn installed on your system. If it is not yet installed, you can run:

npm install --global corepack
corepack enable
hash -r

If you'd prefer to develop on the cloud, Gitpod provides a fully automated development environment for this Strapi project, and the development environment is set up with just a single click. If you'd prefer to use Gitpod, follow these steps to get started:

1. Click the Open in Gitpod button above. Note: you'll need to have an account on Gitpod before proceeding with the next steps (this requires a GitHub account).
2. Click the Continue button.
3. Relax, a development environment is being set up for you in the first terminal.

Once you have a development environment, you can set up your local site!

./setup.bash

yarn

In one terminal, run develop, this will live rebuild your application as you make changes:

yarn develop

If you want autoreload disabled, you can just run build and then start:

yarn build
yarn start

yarn test

If you are running locally, your site should be available in the output after you run yarn develop - you will see something like

One more thing...
Create your first administrator 💻 by going to the administration panel at:
┌─────────────────────────────┐
│ http://localhost:1337/admin │
└─────────────────────────────┘

To access the your deployment on Gitpod, you will have to confirm the message that pops up telling you where to access it. You can see your open ports with

gp ports list

Before creating a pull request, test a final time and check for errors:

yarn check:all

We provide a couple of scripts to automatically fix linting and formatting issues, where possible:

yarn lint:fix
yarn format:fix

If gitpod give you an error like the following:

Pushing to https://github.com/distributeaid/aggregated-public-information.git
remote: Permission to distributeaid/aggregated-public-information.git denied to [my github username].
fatal: unable to access 'https://github.com/distributeaid/aggregated-public-information.git/': The requested URL returned error: 403

You may not have the GitHub providers configured correctly. You can fix this by going to the integrations page in Gitpod's integrations settings and ensuring Github and its permissions are enabled.

At this point, Gitpod will open GitHub to complete the integration. Once you've done that, you should be able to push to the repository.

• Distribute Aid home - see what we're about and how to get in touch
• DA Github home - an overview of our projects
• DA Project page - see where to jump in!

• Strapi comes with a full featured Command Line Interface (CLI) which lets you scaffold and manage your project in seconds.
• Resource center - Strapi resource center.
• Strapi documentation - Official Strapi documentation.
• Strapi tutorials - List of tutorials made by the core team and the community.
• Strapi blog - Official Strapi blog containing articles made by the Strapi team and the community.
• Changelog - Find out about the Strapi product updates, new features and general improvements.

Feel free to check out the Strapi GitHub repository. Your feedback and contributions are welcome!

• Discord - Come chat with the Strapi community including the core team.
• Forum - Place to discuss, ask questions and find answers, show your Strapi project and get feedback or just talk with other Community members.
• Awesome Strapi - A curated list of awesome things related to Strapi.