Quickstart

Nesta seção, você encontra um guia de começo rápido para usar Stacks.

Contexto

O exemplo rápido é de uma aplicação que utiliza a Stack hello-stacker para gerar a estrutura básica de uma página web em HTML.

Siga os passos abaixo para criar a estrutura de uma página web com a Stack hello-stacker. Esses são os mesmos passos para criar uma aplicação real.

Passo 1. Instalar o STK CLI

Instale o STK CLI de acordo com o seu sistema operacional:

Configurar o seu usuário no Git

Após instalar o Git e o STK CLI, configure o usuário e o e-mail da conta do seu repositório. No terminal, execute a sequência de comandos a seguir:

Passo 1. Configurar o seu nome de usuário e email

Nome:

git config --global user.name "{username}"

E-mail:

git config --global user.email "{email}"

Passo 2. Conferir a configuração

Execute na sequência os comandos abaixo:

git config --get user.name

Em seguida:

git config --get user.email

Passo 2. Importar uma Stack

Para criar uma aplicação você precisa de uma Stack como modelo. Para importar uma Stack utilize o comando abaixo:

stk import stack <URL_DA_STACK_NO_GIT>

Para esse exemplo, importe a Stack hello-stacker:

stk import stack https://github.com/stack-spot/stack-hello-stacker

Para encontrar uma Stack e a URL para utilizar neste comando, acesse o portal dos Estúdios onde estão as Stacks disponíveis na StackSpot.

Passo 3. Consultar Stacks, Templates, Plugins e Stackfiles

Antes de criar uma aplicação, verifique cada um dos recursos das Stacks que podem ser usados para gerar uma aplicação:

Stacks

Confira as Stacks que estão disponíveis para uso. Execute o comando:

stk list stack

Leia mais sobre Stacks.

Templates

Confira os Templates disponíveis e o tipo de recurso que é disponibilizado. Execute o comando abaixo:

stk list template

Leia mais sobre Templates.

Plugins

Confira os Plugins disponíveis e as capacidades que cada Plugin adiciona em sua aplicação. Execute o comando abaixo:

stk list plugin

Leia mais sobre Plugins.

Stackfiles

Confira os Stackfiles disponíveis e os conjuntos de Templates e Plugins que serão adicionados em sua aplicação. Execute o comando abaixo:

stk list stackfile

Guarde o nome do Stackfile que você quer usar, você vai precisar utilizá-lo no próximo passo.

Leia mais sobre Stackfiles e como usar um Stackfile.

Passo 4. Criar uma aplicação com o Stackfile

Agora, você já pode criar a aplicação, utilize o comando abaixo:

stk create app myApp --stackfile <NOME_DA_STACK/NOME_DO_STACKFILE>

Para o exemplo com a Stack hello-stacker, execute o comando abaixo:

stk create app helloStacker --stackfile stack-hello-stacker/default

O Stackfile do projeto pede para você escolher qual mensagem gostaria de utilizar para saudar o usuário. Utilize as setas do teclado para selecionar a melhor opção e aperte a tecla Enter para confirmar e avançar.

Para mais informações sobre os parâmetros disponíveis, execute o comando stk create app --help ou acesse a seção sobre o comando stk create app.

Passo 5. Abrir aplicação

Navegue para a pasta criada do seu projeto, no caso deste exemplo é:

cd helloStacker

Abra no seu browser, o arquivo index.html. Você também pode abrir pelo terminal usando o browser default:

  • Windows:

    start index.html
    
  • MacOS:

    open index.html
    
  • Linux (depende do pacote xdg-utils):

    xdg-open index.html
    

Passo 6. Aplicar um Plugin

O Stackfile aplicou um Template e um Plugin ao projeto, mas a Stack possui mais Plugins que para serem utilizados. Consulte os Plugins disponíveis antes de aplicá-los.

Execute o comando abaixo para consultar os Plugins:

stk list plugin

Confira o exemplo abaixo:

Agora, execute o comando dentro do diretório da aplicação:

stk apply plugin <NOME_DA_STACK/NOME_DO_PLUGIN>

No caso do hello-stacker, a proposta é melhorar a aplicação para que a mesma saiba o nome do usuário ao visitar a página.

Assim dentro da pasta do projeto, utiliza-se o comando abaixo:

stk apply plugin stack-hello-stacker/plugin-hello-stacker

Retorne para o navegador e atualize a página com arquivo index.html aberto anteriormente, ou faça novamente as instruções do Passo 5 perceba a nova funcionalidade adicionada na página web.

Você acaba de concluir a jornada para criar uma aplicação e adicionar uma funcionalidade. Para ver o resultado final utilize as instruções do Passo 5 novamente.

Lembre-se que os passos que você fez, utilizaram o Stackfile default, por isso foi necessário aplicar um Plugin para ter mais funcionalidades. Se você já tivesse utilizado o Stackfile hello-stacker-ask-name essa etapa não seria necessária, pois o Plugin já teria sido aplicado.

Próximos Passos

  • A StackSpot tem estúdios com Stacks disponíveis pra você começar a utilizar agora! Acesse o portal StackSpot escolha o seu estúdio e veja tudo o que você pode fazer com cada Stack.

  • Para entender melhor os conceitos da StackSpot, confira mais detalhes na seção Glossário.