🧩 @ioasys/ion Starter Kit for Next.js

Bem-vindo ao @ioasys/ion Starter Kit, o ponto de partida oficial para criar aplicações Next.js utilizando o design system privado @ioasys/ion.

Este template foi desenvolvido pela ioasys para oferecer uma base moderna, consistente e integrada com as boas práticas do time de frontend.

---

🚀 Iniciando um novo projeto

Crie um novo projeto Next.js a partir deste template com o comando abaixo:

npx create-next-app@latest --example "https://github.com/ioasys/ion-starter-kit-nextjs" [nome-do-projeto]

Substitua [nome-do-projeto] pelo nome desejado para seu novo repositório.

---

⚙️ Pré-requisitos

Antes de começar, garanta que você tenha instalado:

• Node.js (versão LTS recomendada)
• npm, yarn, pnpm ou bun
• Git (necessário para clonar o template via create-next-app)

---

💻 Como rodar o projeto

Após clonar ou criar o projeto, instale as dependências e execute o servidor de desenvolvimento:

npm install
npm run dev

A aplicação estará disponível em http://localhost:3000.

---

📚 Recursos e Documentação

• Documentação oficial do @ioasys/ion
  Acesse a documentação do design system para conhecer componentes, tokens e guidelines:
  👉 https://ion.ioasys.com.br

• Wikijs da ioasys
  Repositório central com diretrizes, padrões de código e processos do time de frontend:
  👉 https://wikijs.ioasys.com.br

---

🧠 Sobre o Ion

O @ioasys/ion é o design system privado da ioasys, criado para garantir consistência visual, qualidade de código e eficiência no desenvolvimento das interfaces dos produtos da empresa.
Este starter kit traz uma configuração base pronta para uso, com:

• Estrutura Next.js 15
• Integração com o design system Ion
• Configuração inicial de tipografia e tokens
• Ambiente pronto para Storybook, lint e testes

---

🏗️ Estrutura do projeto

├── public/              # Assets públicos (ícones, logos, etc.)
├── src/
│   ├── app/             # Rotas e páginas Next.js
│   ├── components/      # Componentes
│   ├── contexts/        # React contexts e providers
│   ├── hooks/           # Hooks reutilizáveis
│   ├── services/        # Chamadas a APIs e integrações
│   ├── types/           # Tipagens TypeScript
│   ├── styles/          # Configurações de tema e Tailwind
│   └── utils/           # Funções auxiliares
├── package.json
└── README.md

---

🧩 Licença

Este projeto é de uso interno da ioasys.
O conteúdo, código e design system não devem ser compartilhados publicamente sem autorização prévia.

---

ioasys © 2025 — Starter Kit Ion + Next.js
Desenvolvido com 💜 pelo time de frontend.