This document discusses key factors to consider when building an open source product composed of reusable components. It covers prioritizing features, code quality, issue tracking, documentation, commercial features, pull requests, ecosystem compatibility, component structure, state management, styling, configuration, dependencies, development environments, versioning, continuous integration, deployment, and the tradeoffs between open source and commercial tools. The goal is to share lessons learned in developing reusable components and component libraries.

1. BUILDING BIT
Lessons learned in the trenches

2. Gilad Shoham
Dev & Open
Source Leader
@bit
shoham.gilad@gmail.com
gilad@bit.dev
https://github.com/GiladShoham
@shohamgilad

3. KEY FACTORS
Building an open source product

4. Prioritization of features
(community vs. organizations)
KEY FACTORS

5. Code quality is your quality
KEY FACTORS

6. Issue/task management
KEY FACTORS

7. Docs: users & developers
KEY FACTORS

8. Commercial features in OSS? (‘bit login’)
KEY FACTORS

9. Get and give (!) pull request
KEY FACTORS

10. Ecosystem compatibility
KEY FACTORS

11. “Building with components”
Sounds simple, right?

13. ● Create & Share
● Team structure
● Versioning
● CI
APP VS COMPONENTS

14. ● State
● Styling
● Config
● Bundling vs Transpiling
● Relative paths
● Dev env (build & test)
Dependencies
CREATE & SHARE

15. ● Global
● Component is aware to outside
structure
STATE
“It’s hard to reuse stateful logic between
components” (react official docs)

16. ● Global
● Breaks isolation (affect others)
● Support theming
● Consistency
STYLING

17. ● Project coupling
● Components configuration
○ Dependencies
○ Metadata
○ Entry file
CONFIG

18. BUNDLING VS TRANSPILING
(Apps)
(Components)

19. RELATIVE PATHS
import Button from '../../../../../button';
import Button from '@my-org/button';

20. DEPENDENCIES
● Peer dependencies
● Duplications
● Bundle size

21. DEV ENV

22. AUTONOMOUS
TEAMS

23. VERSIONING
Individual vs entire component library

24. GRAPH CI

25. DEPLOYMENT
Continuous
Composition

26. DEMO

27. MEET BIT

28. CLI - (Open source) VS web (commercial)
VS

29. CLI - Isolate, sync, version management
KEY FACTORS

30. Web - discover, collaborate, experience
KEY FACTORS

31. DISCOVER

32. EXPERIENCE

33. Conclusion

34. Join the community
KEY FACTORS
10K 10K 10K

35. Thanks!