forked from penpot/penpot-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
faqs.njk
395 lines (321 loc) · 21.4 KB
/
faqs.njk
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
---
title: FAQs
layout: layouts/faqs.njk
eleventyNavigation:
key: FAQs
order: 5
---
<div class="main-illus">
<img src="/img/home-faq.png" alt="FAQs" border="0">
</div>
<h1 class="main-title">Frequently asked questions</h1>
<p class="main-paragraph">
You probably arrived here because you either wanted to understand the Why Penpot or the How Penpot questions. Both are fine and we have grouped those questions attending to that soft categorisation. This FAQ will continue to evolve and, at some point, will probably require more ergonomics, filters and search. For now, let’s see how it goes.
</p>
<p class="advice">
Missing a question? This is a work in progress, for any suggestions please write us at <a href="mailto:support@penpot.app" target="_blank">support@penpot.app</a>
</p>
<hr/>
<h2 id="why-penpot" class="secondary-title">
Why Penpot?
<a class="direct-link" href="#why-penpot">#</a>
</h2>
<p>
<p class="main-paragraph">
These are questions related to the fact that Penpot even exists or what is particularly different and new about it.
</p>
<h3 id="who-created-penpot-why" class="secondary-title">
Who created Penpot? Why?
<a class="direct-link" href="#who-created-penpot-why">#</a>
</h3>
<p>
There is a company called <a href="https://kaleidos.net" target="_blank">Kaleidos Open Source</a> that has been long known for its commitment to free & open source software and a more diverse and inclusive workplace where cross-domain teams really enjoy working together. Kaleidos launched <a href="https://taiga.io" target="_blank">Taiga</a> a few years ago to deal with the absence of a truly agile open source project management tool. The next major pain in our ranked list of outrageous open source absentees was a design & prototype tool like Figma, Sketch or Invision.
</p>
<p>
At Kaleidos we believe that the tools that we use to build end products should be as accessible to everyone, regardless of their background, skills or purchasing power. Also, not having a free & open source UX/UI tool that would make devs participate in the design process and bridge the gap between UX/UI and code was a terrible itch for us.
</p>
<p>
<p>
We created Penpot out of the need to enjoy design freedom for cross-domain teams.
</p>
<h3 id="why-open-source" class="secondary-title">
Why specifically Open Source?
<a class="direct-link" href="#why-open-source">#</a>
</h3>
<p>
It’s our very personal choice to make sure that we create tools that inject more freedom into the system. Open Source means pursuing a fairer society, where opportunities are more evenly distributed. Software Technology has the unique advantage, compared to other industries and intellectual property, of having almost zero cost to replicate itself, thus providing a wonderful chance to massively distribute the tools for a more digitally sovereign society.
</p>
<p>
Besides the pure license aspect of it and its legal framework, Open Source fosters more engaging communities where the lines between user and contributor are often blurred.
</p>
<p>
In particular, we chose the very respected Mozilla Public License 2.0 because it made software delivered through the web or a service subject to the same rules as software that runs natively on your operating system.
</p>
<h3 id="why-svg-as-its-native-format" class="secondary-title">
Why is SVG its native format?
<a class="direct-link" href="#why-svg-as-its-native-format">#</a>
</h3>
<p>
SVG (Scalar Vector Graphics) is a widely used Open Standard by the <a href="https://www.w3.org/TR/SVG2/" target="_blank">W3C</a>. It permeates the web, the mobile world and visualisation outputs across a myriad of platforms.
</p>
<p>
Embracing SVG was a technical challenge but it was a huge opportunity too. It makes a Penpot design itself valid code already. Moreover, the potential for integrations and interoperability are infinite.
</p>
<p>
When you are certain that a part of your design is SVG and you live-export that SVG as part of your code repository, you can have back and forth changes through the SVG files. Also, a “continuous design” process could be finally at hand.
</p>
<p>
Using SVG means that there is no translation between a design and its “mathematical” representation. The design is the SVG and the SVG is the design. This is a triumph for cross-domain collaboration.
</p>
<h3 id="why-is-penpot-different-from-proprietary-products" class="secondary-title">
Why is Penpot different from [X proprietary product]?
<a class="direct-link" href="#why-is-penpot-different-from-proprietary-products">#</a>
</h3>
<p>
It would be tempting to go on a feature-comparison mode here. That’s not going to happen. In terms of functionality Penpot is just fine already and with every new month, we will be bridging the gap between other well-known tools (founded between 2010 and 2012) and our hectic release cycle.
</p>
<p>
What is really different is the combination of four key elements:
</p>
<ol>
<li><strong>Open Source</strong>. This is a game-changer for the design and prototype world. It means you can trust your designs are your own. You can adapt or improve the code or benefit from others doing so. You can host your own Penpot instance (also, native app in the works). You can integrate it the way you want. There’s no limit with technology sovereignty. </li>
<li><strong>SVG</strong>. The fact that we don’t go for yet another proprietary format is a blow of fresh air. SVG is what code needs and wants, making the cooperation between design and code suddenly much easier. </li>
<li><strong>Cross-domain team focus</strong>. Teams that are able to integrate many different skills and backgrounds and still enjoy a fruitful conversation (and project) are amazing to watch. Penpot aims to deliver the perfect tool for visual designers that is wholeheartedly embraced by developers too.</li>
<li><strong>No platform dependencies</strong>. Penpot requires a browser, that’s it. If you want to host your own Penpot instance, that’s fine too. We plan to release a native app bundle later this year.</li>
</ol>
<p>
There is a theme here. Universal access. That’s why we love to call our product Penpot, there’s nothing more personal and yet more universal than a pot full of pens. It’s all about choice.
</p>
<h3 id="why-clojure-and-clojurescript" class="secondary-title">
Why did you develop Penpot using Clojure and Clojurescript?
<a class="direct-link" href="#why-clojure-and-clojurescript">#</a>
</h3>
<p>
Penpot is a very specific type of tool that demands high performance on the web. Penpot also has the challenging task of seamlessly manipulating zillions of mathematical objects with no information loss. Functional programming languages like Clojure excel at this.
</p>
<p>
It is one of those instances where you absolutely need a specific technology to be able to achieve a robust tool like Penpot in a short period of time.
</p>
<p>
Since Clojure is not (yet?) a mainstream programming language, we are making sure that there will be ways to extend Penpot using other more common languages such as Javascript. Also, at the backend level, appropriate APIs will be in place to easily connect Penpot with other platforms.
</p>
<h3 id="why-release-penpot-as-alpha" class="secondary-title">
Why did you release Penpot as an Alpha?
<a class="direct-link" href="#why-release-penpot-as-alpha">#</a>
</h3>
<p>
We couldn’t wait any longer. Back in February 2020 we promised that it would take as a year to develop a sort of 1.0. The “alpha” tag might be misleading, it’s quite stable and feature-rich but in some ways it’s still immature with regards to our vision.
</p>
<h3 id="why-beta" class="secondary-title">
Why did Penpot move to Beta?
<a class="direct-link" href="#why-beta">#</a>
</h3>
<p>
Penpot is labeled as beta from the beginning of November 2021. Since its public launch in February 2021, Penpot capabilities and benefits have grown at an astonishing fast rate. Meanwhile, we constantly came back to one recurring question: Is Penpot really an alpha product anymore?
</p>
<p>
The combination of core features, maturity, stability and how comfortable teams seem to be while using it made the trick. Also, we saw amazing validation from the community as a whole (take a look at our github). Learn more about the details behind the change <a href="https://penpot.app/why-beta.html" target="_blank">here</a>.
</p>
<p>
Anyway, enjoy it for what it is, we will keep releasing iterations of our hopeful plans.
</p>
<hr/>
<h2 id="how-penpot" class="secondary-title">
How Penpot?
<a class="direct-link" href="#how-penpot">#</a>
</h2>
<p>
<p class="main-paragraph">
These are questions related to practical aspects of Penpot or its capabilities.
</p>
<h3 id="how-is-penpot-sustainable" class="secondary-title">
How do you plan to make Penpot’s development sustainable?
<a class="direct-link" href="#how-is-penpot-sustainable">#</a>
</h3>
<p>
<a href="https://kaleidos.net" target="_blank">Kaleidos Open Source</a>, the company behind Penpot, has the resources and the team needed to do that. If Penpot really succeeds and demands more and more resources, a bigger team and a bigger infrastructure, we will need to find ways to monetize some aspects of Penpot. Many Open Source platforms have been very successful at that, without reverting to closing up the source code.
</p>
<p>
SaaS subscriptions offer a quite valid and straightforward business model on top of Open Source. We are also considering marketplace models à-la-Wordpress or big-enterprise-focused features for supported Penpot deployments à-la-Gitlab. No bullshit Open Core models based on some iteration of a “Tax the rich” sound reasonable but we’re still unsure about what would make sense. At the moment, though, this is something we don’t plan to address until 2023.
</p>
<p>
If you would like to know more about our track record, just take a look at Taiga and its AGPL 3.0 licensing model. It’s great to have first-hand experience.
</p>
<h3 id="penpot-funding" class="secondary-title">
What is this "Kaleidos Ventures SL" stuff I see when I do some research on who's behind Penpot? You guys are a VC or what?
<a class="direct-link" href="#how-is-penpot-sustainable">#</a>
</h3>
<p>
<i>Since we keep getting this question, we decided it was far simpler to just change our company name so we will soon be dropping the “ventures” bit. Still, please read what follows.</i>
</p>
<p>
No, we're not. Kaleidos Ventures SL is just a private rebranding of Kaleidos Open Source SL. It's the same bunch of people that 10 years ago created a company to build digital products for other startups. Many of us had been free & open source enthusiasts and hackers for over 10 years (mid 90's) already back then, so we wanted to make sure we stood behind our values around technology and society. Thanks to our internal innovation and incubation process (<a href="https://piweek.com" target="_blank">ΠWEEK</a>), <a href="https://taiga.io" target="_blank">Taiga</a> was born a few years ago. In recent times, we also needed something like Penpot, so we created an internal prototype, after which we asked ourselves whether it would be challenging but also cool to ditch all third-party consultancy contracts and just focus on OUR free & open source products. We said "Yes! Let's do this!". To name this risky and exciting business shift during pandemic times, it was convenient to create a child company, Kaleidos Ventures SL, and we asked for a bit of seed money to make sure we could build a solid professional tool, but the transition has been flawless and our <a href="https://kaleidos.net" target="_blank">main website</a> has remained almost the same, which is very nice.
</p>
<p>
If you'd like to listen to Kaleidos Ventures SL CEO, there's <a href="https://possiblefutures.tech/posts/interview-with-penpot-ceo-pablo-ruiz-muzquiz-on-open-source-design-and-ethical-funding" target="_blank">this no-bullshit non-confirming interview</a> by Clayton Dewey which got featured at <a href="https://opensource.com/article/21/9/open-source-design" target="_blank">opensource.com</a>.
</p>
<p>
This FAQ entry was inspired by a question from Aral Balkan on Mastodon.
</p>
<h3 id="how-to-download-and-install" class="secondary-title">
How can I download and install Penpot for my team?
<a class="direct-link" href="#how-to-download-and-install">#</a>
</h3>
<p>
Current private Penpot instances are only requiring basic Docker knowledge. You can run your own Penpot server following these instructions:
<br>
<a href="https://help.penpot.app/technical-guide/getting-started/">help.penpot.app/technical-guide/getting-started</a>
</p>
<p>
There’s a community contribution around a docker-less deployment using podman:
<br>
<a href="https://blog.linuxgrrl.com/2022/01/19/running-penpot-locally-docker-free-with-podman">blog.linuxgrrl.com/2022/01/19/running-penpot-locally-docker-free-with-podman</a>
</p>
<h3 id="how-can-penpot-work-offline" class="secondary-title">
How can I make Penpot work offline?
<a class="direct-link" href="#how-can-penpot-work-offline">#</a>
</h3>
<p>
At the moment that would require that you install Penpot locally and so you connect to localhost. Instructions for this using Docker can be found here: <a href="https://help.penpot.app/technical-guide/getting-started/">https://help.penpot.app/technical-guide/getting-started/</a>
</p>
<p>
For a simpler approach, more akin to downloading a piece of software and running it on top of your operating system, please wait for our Electron-based app bundle later this year.
</p>
<h3 id="where-is-penpot-code" class="secondary-title">
Where can I find the code?
<a class="direct-link" href="#where-is-penpot-code">#</a>
</h3>
<p>
You can download the code or clone the repository at <a href="https://github.com/penpot" target="_blank">Github</a>.
</p>
<h3 id="best-browser-experience" class="secondary-title">
How can I enjoy the best Penpot browser experience?
<a class="direct-link" href="#best-browser-experience">#</a>
</h3>
<p>
Cross-browser support is a key aspect of Penpot so we give much thought and care to it.
</p>
<p>
Our current preference solely in terms of experience is:
</p>
<ol>
<li>Chrome (or Chromium/Blink based browsers/Edge)</li>
<li>Firefox</li>
<li>WebKit (Safari / Epiphany)</li>
</ol>
<h3 id="how-enjoy-penpot-on-the-cloud" class="secondary-title">
How can I enjoy Penpot on the cloud?
<a class="direct-link" href="#how-enjoy-penpot-on-the-cloud">#</a>
</h3>
<p>
The easiest way to enjoy Penpot is quite simple. You simply go to <a href="https://penpot.app" target="_blank">https://penpot.app</a> and click on the Signup button. You will be asked to create an account. We only ask for an email. There are some authentication providers available, too.
</p>
<h3 id="how-work-with-other-people" class="secondary-title">
How can I work together with other people?
<a class="direct-link" href="#how-work-with-other-people">#</a>
</h3>
<p>
The easiest way to do that in Penpot is to create a team and add projects as you need them. All those projects and files will be available for your team and you will be able to work either asynchronously or simultaneously.
</p>
<p>
A Penpot user can be part of many different teams and have access to all their available projects.
</p>
<p>
Of course, Penpot also gives you the possibility to work on your private projects or drafts.
</p>
<h3 id="how-share-designs-with-external-stakeholders" class="secondary-title">
How can I share my designs with external stakeholders?
<a class="direct-link" href="#how-share-designs-with-external-stakeholders">#</a>
</h3>
<p>
If you want to have a shareable URL to show your designs you can do it from the VIEW mode: launch it using the PLAY button at the top right of the file, and you'll find a SHARE URL button to create the link at the top right. Copy and send that link for other people to access the design.
</p>
<p>
You can always invalidate a shared URL if you don’t wish to continue to make it accessible through that link.
</p>
<h3 id="how-to-stay-up-to-date-with-penpot-news" class="secondary-title">
How can I stay up-to-date with the latest Penpot news and what's to come?
<a class="direct-link" href="#how-to-stay-up-to-date-with-penpot-news">#</a>
</h3>
<p>
We will be sharing our progress and news through different channels:
</p>
<ul>
<li>Penpot Social Networks: <a href="https://twitter.com/penpotapp" target="_blank">Twitter</a>, <a href="https://fosstodon.org/@penpot/" target="_blank">Mastodon</a>, <a href="https://www.instagram.com/penpotapp/" target="_blank">Instagram</a>, <a href="https://www.linkedin.com/company/penpot/" target="_blank">Linkedin</a>. </li>
<li><a href="https://www.youtube.com/channel/UCAqS8G72uv9P5HG1IfgnQ9g" target="_blank">Penpot Youtube channel</a>: Subscribe to get updates when we upload new Penpot tutorials, demos of features and talks.</li>
<li><a href="https://penpot.app/#newsletter" target="_blank">Newsletter</a>: Don’t miss the important stuff by subscribing to our low-traffic newsletter.</li>
<li><a href="https://github.com/penpot/penpot" target="_blank">Penpot Github Project</a>: Follow us to keep up to date with the project progress and get involved in the discussions.</li>
</ul>
<h3 id="how-join-community-chat" class="secondary-title">
How can I join the community chat?
<a class="direct-link" href="#how-join-community-chat">#</a>
</h3>
<p>
You can jump in right here <a href="https://gitter.im/penpot/community" target="_blank">https://gitter.im/penpot/community</a>
</p>
<p>
Say hello and introduce yourself! Happy to have you!
</p>
<p class="advice">
We are planning to launch a new community space soon to allow for everyone to be part of the conversation.
</p>
<h3 id="how-use-penpot-with-inkscape" class="secondary-title">
How can I use Penpot together with Inkscape?
<a class="direct-link" href="#how-use-penpot-with-inkscape">#</a>
</h3>
<p>
Inkscape is a very powerful Open Source vector drawing tool. At Penpot we use it daily for our SVG creations. A very common use case we have is to use Inkscape to work with vector illustrations, icon sets and other graphic assets, before importing them into Penpot to create more complete and visually attractive interface designs. There are other tools that can complete your workflow, such as Quant-UX, which is very good for learning about your users’ interactions with your product.
</p>
<h3 id="learn-how-to-use-penpot" class="secondary-title">
How can I learn how to use Penpot?
<a class="direct-link" href="#learn-how-to-use-penpot">#</a>
</h3>
<p>
Right now, our suggested approach would be to take a look at our <a href="https://www.youtube.com/channel/UCAqS8G72uv9P5HG1IfgnQ9g" target="_blank">Youtube channel</a> and enjoy the quick tutorials on many aspects of Penpot.
</p>
<h3 id="how-can-contribute" class="secondary-title">
How can I contribute to Penpot?
<a class="direct-link" href="#how-can-contribute">#</a>
</h3>
<p>
We are working on a comprehensive guide on how to contribute to Penpot. There are many ways this can be achieved. Designs, code, testing, reporting bugs, improving documentation, sharing Penpot designs with #MadeWithPenpot, translating Penpot to your favourite language, setting up training sessions, etc.
</p>
<p>
For now, we have a rather limited <a href="https://github.com/penpot/penpot/blob/develop/CONTRIBUTING.md" target="_blank">contribution guide</a> that you can already use but we plan to improve this very soon.
</p>
<hr/>
<h2 id="other-faqs" class="secondary-title">
Other frequently asked questions
<a class="direct-link" href="#other-faqs">#</a>
</h2>
<p>
<p class="main-paragraph">
Here we include some other interesting questions people have asked or that we would like to directly address.
</p>
<h3 id="roadmap-short-mid-term" class="secondary-title">
What is in Penpot’s roadmap for the short-/mid-term?
<a class="direct-link" href="#roadmap-short-mid-term">#</a>
</h3>
<p>
Some of the things planned for the near future:
</p>
<ul>
<li>Responsive layout (also known as autolayout).</li>
<li>Advanced components (states, variants, interactions).</li>
<li>Sharing options with fine grained permissions.</li>
<li>[2022 - Q4] Taiga confluence, API and plugin framework.</li>
<li>... and much more.</li>
</ul>
<p>
You can check the advance of the project at <a href="https://tree.taiga.io/project/penpot/backlog" target="_blank">Taiga</a>.
</p>
<h3 id="design-patterns" class="secondary-title">
Did the team find a pattern (design, interaction, tool) that could be improved but decided to keep it because the reference tools already made it familiar to the user?
<a class="direct-link" href="#design-patterns">#</a>
</h3>
<p>
Short answer would be no, we do not keep things from improving because of the potential loss of familiarity.
</p>
<p>
It is true that we are using known patterns to ease the learning curve, this is part of Penpot’s strategy. Given that, we could say that “familiar” is included in our definition of success, but this might be for a different, also interesting, conversation. We do not hide that we have kept an eye not only on Figma but also on many other “usual suspects” (Sketch, Adobe XD, Inkscape, Webflow, Blender...) to study common patterns. However, our design decisions are based not only on previous research but also on testing solutions with users. Therefore, if we were to find that something works better for us in a different way, we’d go for it. Masks and toolbars are some examples of this approach.
</p>