Simply copy and paste the following command line in your terminal to create your first Strapi project.
npx create-strapi-app my-project
Strapi’s note: this is a guest post from Baldeep Singh Kwatra, a great Strapi user in Delhi, willing to share his experience on Strapi. He's been using the project for more than a year now.
Gone are the days when server-side rendering of web pages was heavily used and servers were solely responsible to generate the entire web page for the clients. Remember JSP, PHP, asp? Now we have to deal with the rise of new gadgets, the advancement of hardware and technology incorporation. New clients such as smartphones, smartwatches, smartTV, IoT’s have bombarded the market, and heavily consume data.
For sure you can expose data (API) using traditional CMS but it could become cumbersome and painful. I am not saying you can’t do that. It's just not thought out to do that from the ground up. Currently, there is a heavy demand to decouple the data/logic and presentation layer whereby the data is exposed as JSON response. The client, whether a browser or an app, should be able to render it. This enables to work faster. Front end and back end teams can work individually without much interference.
So what we need is an API driven architecture with the power to manage the content as traditional CMS do. Here comes the new catchy buzz word ‘Headless CMS’ - A CMS without its head, but surely not without brains 😉 It is a CMS that is front-end agnostic. A CMS that has no view layer. It should just be capable to store and expose the data.
And this is the real need of the hour for almost every project. If this is what you need then say goodbye to your traditional CMS and welcome to the era of Strapi!
By the way, did you know that the name Strapi comes from "Bootstrap your API"?
You might think that exposing an API can be done easily using any other stack like Spring Boot or Ruby On Rails, etc. I also have worked on them. But since I started working on Strapi, I observed time to market has heavily reduced. All the boilerplate code is reduced and I just focus on the core business logic.
Do you know why? Because all the items listed below are supported out of the box.
It supports all the basic CRUD operations.
You don’t have to write even a single line of code. All you need is a content-type, i.e. how your model looks like. In simpler words what you want to save in your database.
Every API needs to have server-side pagination, which is by default supported by Strapi.
You need to search anywhere in your database tables/collections.
Filtering capabilities with conditional logics without even writing a single database query.
Plug and play from a relational DB to nonrelational DB.
It supports SQLite, MongoDB, MySQL, Postgres.
Uploading files to a directory on the server or directly to an AWS S3 Bucket.
Supports OAuth2 authentication for Google, Facebook, Github, Microsoft, Twitter, Discord.
Manage Roles and Users with API level access.
Choose over REST or GraphQL.
It supports REST by default. But you can install a GraphQL plugin to and expose/mutate data.
Strapi is built on NodeJS. It internally uses KoaJS as its framework which is developed by the team who created ExpressJS, marketed as ‘Next generation web framework’. It works with almost all major databases. For SQL based databases, it uses BookshelfJS internally and for NoSQL DB, it uses Mongoose ORM (strapi-hook-mongoose).
The stack itself is very promising as it is completely open-source and the community is also increasing tremendously. All the major common modules like sending emails, uploading files, managing users, are developed in the form of plugins. You can plug and play and tailor them according to your needs.
Let me walk you through the below cheat sheet that you should always keep handy 😉
Strapi only requires Node.js and npm. The current recommended version to run strapi is Node v10 (current LTS). This is all that is needed before Strapi can run on your local environment. Download it here
1npm install strapi@beta -g
This will set up Strapi on your system globally.
1strapi new my-app
Three magical words to create your project.
Go to the project folder and run the project in dev mode
Once the above step is done, navigate to http://localhost:1337/admin and create your first admin. At least one account is mandatory.
Navigate to Content Type Builder and create your content type. Once done you can add data to it. Strapi will automatically create the file, shown below, for you once you save the content type.
Once the above step is done, navigate to http://localhost:1337/cities
Go to Roles & Permissions and assign permissions to your models. Permissions includes (count + create + find + findOne + delete + update).
The /api folder contains all the content-types that you create. For example, see the /article folder inside /api.
The /build folder is generated when you run your project. It contains js files for the dashboard which is built on react.
The /config folder contains configuration files for database, server, caching, locales(i18N), cron, etc.
The /extensions folder is where the plugins that you install are.
Here's hoping you learned a thing or two with this piece. I sure did! :)
Do you have a story you would like to share with the community? Let's talk about it here 🚀
Pierre created Strapi with Aurélien and Jim back in 2015. He's a strong believer in open-source, remote and people-first organizations. You can also find him regularly windsurfing or mountain-biking!