Get started

This guide will go over the basics of setting up a Fuchsia environment with custom models and collections.

1. Create an account

Before we start creating awesome content, create an official Fuchsia account by registering here. Once you sign up you will need to verify your email by clicking the link sent to you.

2. Create a Project

Projects are the base of everything in Fuchsia. A project can be shared between many users and every project has an owner. Once you're logged in and have verified your account - you can ask someone to add you to their project OR you can create your own project.

All projects start as free but can be optionally upgraded later if needed. To create a project:

  1. Head over to the projects page and click New Project.

  2. Enter a project name and click Create.

  3. That's it! Congrats, you are now a project owner! 🎉

3. Setup a Model

Now that you have a Project, you can start adding some Model's.

What are models? - Models are the building blocks for structuring your content. For example: if you have a Gaming site that reviews games, you would create a Game Review model, so that you can review many different games. If you were a news outlet, you would create an Article model so you can later add many different articles.

To create a model:

  1. Make sure you are inside your newly created project.

  2. Click Models inside your left-hand sidebar.

  3. Click the purple New Model button on the right hand side of the screen.

  4. Enter a name for your new model, for example Game Review and then click Save.

4. Add fields to your Model

Once you created your new model, click the grey Edit button to start adding some fields.

Fields are what shape the data in your model. For example, if I had a Person model, I would have fields like First Name, Last Name, Date of Birth etc.

For our Game Review model example, we would want to add a few fields like Title, Genre, Stars, Publisher, Release and Review.

4.1. Field Types

When adding fields to your model, you will see that you must choose a Type for that field. Types help validate the structure and content of the field. In our Game Review model example, our Title field would have a type of Short Text because game titles are usually less than 50 characters. The Release field would have a type of Date and the Review field would have a type of Rich Text so that we can write long reviews with sections, pictures and links!

For a more detailed explanation of all field types, check out our Fields guide.

5. Start a Collection

Now that you have a model setup, you can start creating instances of this model. Collections are for holding logical groupings of records. For example, if we had a Model for building a Car, we would have a collection called Cars that would hold records of different cars.

To continue with the Game Review example, let's create a collection for our reviews:

  1. Head over to the collections page and click New Collection.

  2. Fill out the form by giving it a name of Reviews and select the Game Review model from the drop-down, then click Save.

  3. Click View in the collections table on your new collection to head over to the records page.

6. Add some Records

Now that you have a collection, you can start creating records to fill the collection.

  1. In the records page, Click New Record to start creating a new Game Review record.

  2. In the New Record form, you will see all the fields you specified when creating your model, you may fill it out with any values and click Save.

  3. The record will now be available to be published and will be accessible through the API.

  4. To publish a record, hit the checkbox next to Save button when editing a record.

Congrats! you got through the basics of building flexible dynamic applications with Fuchsia. Checkout our API docs, examples and tutorials to learn more!