create-slice

Use this skill when creating and configuring Hanami 2.x Slices.

---

Quick Reference

---

Core Rules

1. Generate a Slice using the Hanami CLI:

   hanami generate slice api

   Creates slices/api/ with subdirectories including config/routes.rb, actions/, views/, and templates/.

   Verify: Run hanami routes and confirm the new slice's routes appear in the output.

2. Register the Slice in the app:

   # config/app.rb
   # frozen_string_literal: true
   
   module MyApp
     class App < Hanami::App
       slice :api, at: "/api" do
         # Slice-specific configuration
       end
     end
   end

3. Define Slice routes in slices/<name>/config/routes.rb:

   # slices/api/config/routes.rb
   # frozen_string_literal: true
   
   module MyApp
     module Slices
       module Api
         class Routes < Hanami::Routes
           get "/users", to: "users.index"
           get "/users/:id", to: "users.show"
         end
       end
     end
   end

   Verify: Run hanami routes and confirm /api/users and /api/users/:id are listed.

4. Access Slice Actions from routes:

   # Full path: /api/users → slices/api/actions/users/index.rb

5. Import dependencies from another Slice:

   # config/app.rb
   module MyApp
     class App < Hanami::App
       slice :api, at: "/api" do
         import from: :main do
           # Import specific components from the main slice
         end
       end
     end
   end

   Verify: Boot the app (hanami console) and resolve the imported component: MyApp::Slices::Api::Container["main.repositories.users"].

6. Export Slice components for use by other slices:

   # slices/api/config/slice.rb
   module MyApp
     module Slices
       module Api
         class Slice < Hanami::Slice
           export ["repositories.users"]
         end
       end
     end
   end

   Verify: In hanami console, confirm the consuming slice can resolve the exported key.

7. Keep Slices self-contained. A Slice should be able to function independently. Minimize cross-slice dependencies.

8. Use Slices for bounded contexts — common examples include slice :api for public endpoints, slice :admin for dashboards, slice :billing for payments, and slice :main for the default web application.

---

Common Mistakes

• Circular slice dependencies: Slices should be acyclic. If Slice A imports from Slice B, Slice B must not import from Slice A.
• Direct container access across slices: Use import/export for cross-slice communication. Never access Hanami.app["slices.other.component"] directly.
• Misaligned namespaces: Slice components live under MyApp::Slices::Api::. File paths and module namespaces must align.

---

Integration