Developers.italia.it
The developer community designing and developing public digital services in Italy
Install / Use
/learn @italia/Developers.italia.itREADME
Description
Developers Italia is the reference point for the community of developers creating the next generation of digital public services in Italy.
This repository contains the sources of the website. The website is developed using Jekyll.
A GitHub action job builds the sources, getting some data from developers.italia.it-data, and commits the resulting artifacts to the gh-pages branch. The job is also triggered every night to get the latest data.
Documentation
Development
We use Docker and docker-compose to bring up the developer environment, just clone the repo and
-
Copy the
.env.examplefile into.envand modify the environment variables as it suits you..env.exampleholds the detailed description of each variable.cp .env.example .env -
Set the
RUNASvariable to your user:echo RUNAS=$(id -u):$(id -g) >> .env -
Build the container:
docker-compose up
Wait until the Docker logs explicitly say that the website is served at
0.0.0.0:4000 and navigate to http://localhost:4000 to preview the website.
Jekyll will pick up changes to the Markdown files and recompile them on the fly.
If you change the Gemfile or package.json, you'll need to rebuild the image with:
docker-compose up --build
Makefile
Both the build and the Docker files leverage a Makefile, facilitating the execution of more complex routines. You can have a look at the Makefile to know more about the exact commands used to build the website.
Community
Code of Conduct
Please review our Code of Conduct to ensure a great collaboration with the rest of the community.
Contributing
Developers Italia exists also thanks to your contributions! Here is a list of users who already contributed to this repository: <a href="https://github.com/italia/developers.italia.it/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=italia/developers.italia.it" /> </a>
This list is also displayed in the Developers Italia website.
Every contribution is welcome! However, before proceeding further please take a look at our contributing guidelines.
License
Copyright© 2018-present - Presidenza del Consiglio dei Ministri
The source code is released under the BSD license (SPDX code: BSD-3-Clause)
and it's distributed with this license since May 30th 2018.
The previous code has been released under under the MIT license.
Related Skills
clearshot
Structured screenshot analysis for UI implementation and critique. Analyzes every UI screenshot with a 5×5 spatial grid, full element inventory, and design system extraction — facts and taste together, every time. Escalates to full implementation blueprint when building. Trigger on any digital interface image file (png, jpg, gif, webp — websites, apps, dashboards, mockups, wireframes) or commands like 'analyse this screenshot,' 'rebuild this,' 'match this design,' 'clone this.' Skip for non-UI images (photos, memes, charts) unless the user explicitly wants to build a UI from them. Does NOT trigger on HTML source code, CSS, SVGs, or any code pasted as text.
openpencil
2.1kThe world's first open-source AI-native vector design tool and the first to feature concurrent Agent Teams. Design-as-Code. Turn prompts into UI directly on the live canvas. A modern alternative to Pencil.
openpencil
2.1kThe world's first open-source AI-native vector design tool and the first to feature concurrent Agent Teams. Design-as-Code. Turn prompts into UI directly on the live canvas. A modern alternative to Pencil.
ui-ux-designer
Use this agent when you need to design, implement, or improve user interface components and user experience flows. Examples include: creating new pages or components, improving existing UI layouts, implementing responsive designs, optimizing user interactions, building forms or dashboards, analyzing existing UI through browser snapshots, or when you need to ensure UI components follow design system standards and shadcn/ui best practices.\n\n<example>\nContext: User needs to create a new dashboard page for team management.\nuser: "I need to create a team management dashboard where users can view team members, invite new members, and manage roles"\nassistant: "I'll use the ui-ux-designer agent to design and implement this dashboard with proper UX considerations, using shadcn/ui components and our design system tokens."\n</example>\n\n<example>\nContext: User wants to improve the user experience of an existing form.\nuser: "The signup form feels clunky and users are dropping off. Can you improve it?"\nassistant: "Let me use the ui-ux-designer agent to analyze the current form UX and implement improvements using our design system and shadcn/ui components."\n</example>\n\n<example>\nContext: User wants to evaluate and improve existing UI.\nuser: "Can you take a look at our pricing page and see how we can make it more appealing and user-friendly?"\nassistant: "I'll use the ui-ux-designer agent to take a snapshot of the current pricing page, analyze the UX against Notion-inspired design principles, and implement improvements using our design tokens."\n</example>
