Skip to main content
In Sublay, the concept of an “entity” forms the foundation for all activity. While the term itself may not sound immediately intuitive or descriptive, this is intentional—the flexibility of what an entity can represent is what makes Sublay adaptable to a wide range of projects.

​
What is an Entity?

An entity is a core data unit that powers features across Sublay. Its definition depends entirely on the context of the project where Sublay is being used:
  • In a social media project, an entity might represent a single post.
  • In a marketplace, an entity could be a product or listing.
  • In a blog, an entity might be a single article.
  • In a personal website, an entity could even represent a static page, such as an “About” page with a comment section.
The versatility of entities means that they can seamlessly integrate into almost any application, regardless of its domain or purpose.

​
Why Are Entities Important?

Entities are the cornerstone of Sublay because they serve as the foundation upon which other features are built. Consider these examples:
  • Profiles without posts (entities) appear empty.
  • Marketplaces without products or listings (entities) have no content to explore or purchase.
  • Without entities, there would be nothing to comment on, vote on, or add to collections.
Without entities, many of the features that make Sublay powerful simply would not function. They are the backbone of user interaction and content generation.

​
Entities and Existing Data

For developers considering Sublay for an existing project, it’s important to note that entities can “wrap” around your existing data without altering it. This allows Sublay to integrate seamlessly into applications with pre-existing datasets, ensuring compatibility without the need for data restructuring. This flexibility makes it possible to introduce Sublay’s features without disrupting your current workflows.

​
What’s Next?

In the upcoming chapters, we will explore:
  • How to define and manage entities in your project.
  • How entities interact with other Sublay features like comments, feeds, and collections.
  • Best practices for integrating entities into new or existing applications.
Understanding entities is key to unlocking the full potential of Sublay, and we’re excited to guide you through this journey.