Skip to content

flotiq/scully-products-starter

Repository files navigation

Flotiq logo

Scully Starter - Products

This is a Scully starter project for a shop. It's configured to pull products data from Flotiq and can be easily deployed to your cloud hosting - Heroku, Netlify, etc.

Live Demo: https://competent-visvesvaraya-bb732c.netlify.app/

Screenshot

This project was generated with Angular CLI version 9.1.7.

Quick start

  1. Clone project

    git clone https://github.com/flotiq/scully-products-starter
  2. Setup "Product" Content Type in Flotiq

    Create your Flotiq.com account. Next, create the Product Content Type:

    Product content type in flotiq

    Note: You can also create Product using Flotiq REST API.

  3. Configure application

    The next step is to configure our application to know from where it has to fetch the data.

    In src/environments/environment.prod.ts, in src/environments/environment.ts and in src/environments/environment.js change YOUR_FLOTIQ_API_KEY to Read only Flotiq API key.

    Remember to change them back to YOUR_FLOTIQ_API_KEY before committing code to repository.

    You have to also change SNIPCART_API_KEY to your Snipcart public API KEY in src/environments/environment.prod.ts and in src/environments/environment.js to enable cart functionality.

  4. Start developing

        cd scully-products-starter/
        npm install

    If you wish to import example products to your account run:

        flotiq import . [flotiqApiKey]

    It will add 10 images and 4 products to your Flotiq account.

    Note: You need to put your Read and write API key as the flotiqApiKey for import to work. You don't need the Product content type in your account. If you already have products with ids product-1, product-2, product-3 and product-4 they will be overwritten.

    Run npm run start for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

    If you wish to add new elements to the project run npm run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

    Run npm run build:prod to build the project. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.

    To build the static version with Scully run:

    npm run build --prod
    npm run scully -- --scanRoutes
    npm run scully serve

    This will start the Scully static server on http://localhost:1668/

  5. Manage your products using Flotiq editor

    You can now easily manage your products using Flotiq editor

    Managing products using Flotiq

  6. Update Flotiq Angular SDK when you create or update Type Definition

    Everytime you change something in your Content Type Definitions, you have to regenerate Flotiq Angular Package inside project.

    1. Go to your dashboard in Flotiq, and click on Angular icon in "Your API packages" section, to download an SDK with the updated content of your schema. Downloading Angular SDK
    2. Extract downloaded zip in flotiq directory in the project.
    3. Done, you have updated Flotiq Angular SDK in your project!

Further help with Angular

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.

Deploy

You can deploy this project to Netlify in 3 minutes:

Deploy

Collaborating

If you wish to talk with us about this project, feel free to hop on our Discord Chat .

If you found a bug, please report it in issues.