Como Criar uma Aplicação

Nesta seção, você encontra um exemplo de como usar o STK CLI para criar uma aplicação.

Siga os passos abaixo para criar uma aplicação de hello-stacker. Esses são os mesmo passos para criar uma aplicação real.

Passo 1. Instalar o STK CLI

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

Passo 2. Adicionar uma Stack

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

stk import stack <URL_DA_STACK_NO_GIT>

Para adicionar a Stack, execute o comando com a URL da stack:

stk import stack https://github.com/stack-spot/stack-hello-stacker
  • Neste exemplo, foi utilizada a 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 os Stackfiles disponíveis

Uma Stack pode ter mais de um stackfile, que serve como base de uma aplicação.

Consulte os Stackfiles disponíveis em cada Stack, execute o comando:

stk list stackfile

Guarde o nome do Stackfile que deseja usar, você irá usar no próximo passo.

Passo 4. Criar uma aplicação

Agora, você já pode criar um projeto de aplicação, execute o comando:

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

No exemplo da hello-stacker:

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 --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. Escolher um Plugin

Para adicionar mais funcionalidades ao projeto, você pode aplicar plugins.

Para ver quais são os Plugins disponíveis na sua máquina, com os seus respectivos atributos agrupados por Stack, execute o comando:

stk list plugin

Confira um exemplo abaixo:

Passo 7. Aplicar o Plugin

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

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 todos os conceitos da StackSpot, confira na seção Glossário todos os detalhes.