# Summary

Welcome to **MarsBased**! This is the first thing you should read when boarding the **MarsBased** spaceship.

**MarsBased** is an all-remote development consultancy from Barcelona, building web and mobile products using Ruby on Rails, Python and JavaScript. We work at the intersection of business and technology, to help companies with their innovation projects using bleeding-edge technologies like AR/VR and AI.

Here you will find the most important information about the company to help you to get familiar with it. We have also compiled some of our guides & interesting stuff you should read (and some trivia & fun stories to make it more digestible).

If you're a visitor and want to use them, feel free to use them anywhere, but we'd appreciate it that you linked us back in appreciation.

We have decided to make this handbook publicly available so we can share as much as we can with other companies out there, potential candidates and prospective clients alike. Everyone is welcome!

## Sections

1. [Become a Martian](/sections/become-a-martian.md)
2. [First day at MarsBased](/sections/firstday.md)
3. [Buddy System](/sections/buddy.md)
4. [Who is who](/sections/who-is-who.md)
5. [Company culture](/sections/companyculture.md)
6. [What influenced us](/sections/influences.md)
7. [Talks & Podcasts](/sections/talks.md)
8. [What we do](/sections/whatwedo.md)
9. [How we work](/sections/howwework.md)
10. [How we communicate](/sections/howwecommunicate.md)
11. [Whom to ask](/sections/whom-to-ask.md)
12. [Our rituals](/sections/rituals.md)
13. [Development](/sections/development.md)
14. [Project types](/sections/projects.md)
15. [Current projects](/sections/currentprojects.md)
16. [Benefits & Perks](/sections/benefits.md)
17. [Holidays, time off & paid leave](/sections/timeoff.md)
18. [Digital disconnection policy](/sections/policy-digital-disconnection.md)
19. [Travel policy](/sections/policy-travel.md)
20. [Careers at MarsBased](/sections/careers.md)
21. [Software and device usage policy](/sections/policy-software-and-device-usage.md)

## Our guides

For now, we have the following resources available:

1. [Branding guidelines](/our-guides/branding.md)
2. [Project management guidelines](/our-guides/pm-guidelines.md)
3. [Linear guidelines](/our-guides/linear-guidelines.md)
4. [Calendar, Slack & Linear working hours and status guidelines](/our-guides/working-hours-guidelines.md)
5. [File storage, permissions & security](/our-guides/permissionssecurity.md)
6. [Prompt engineering basics](/our-guides/prompts.md)
7. [Our SEO guidelines for new projects](/our-guides/seo-guidelines.md)
8. [Our blogging guide](/our-guides/blogging-guide.md)
9. [How to write a damn good blog post](/our-guides/how-to-blog.md)

## Our development guides

1. [AI Augmented Development](/our-development-guides/ai-augmented-development.md)
2. [Coding guidelines](/our-development-guides/coding-guidelines.md)
3. [Security guidelines](/our-development-guides/security.md)
4. [Our Git & Commit guidelines](/our-development-guides/git-guidelines.md)
5. [Code reviews guidelines](/our-development-guides/code-reviews-guidelines.md)
6. [Testing guidelines](/our-development-guides/testing-guidelines.md)
7. [Our Docker guides](/our-development-guides/docker-guide.md)
8. [React guidelines](/our-development-guides/react-guidelines.md)
9. [Back-end guidelines](/our-development-guides/back-end-development-guidelines.md)
10. [Ruby & Rails guidelines](/our-development-guides/ruby-guidelines.md)
11. [Our Rails ActiveRecord guide](/our-development-guides/activerecord-guide.md)
12. [Some of our used programming patterns](/our-development-guides/patterns.md)
13. [Our schema.org implementation guidelines](/our-development-guides/schema.md)

## Our accessibility guides

1. [Accessibility guidelines](/our-accessibility-guides/a11y.md)
2. [Accessibility for designers](/our-accessibility-guides/for-designers.md)
3. [Accessibility for engineers](/our-accessibility-guides/for-engineers.md)
4. [Resources](/our-accessibility-guides/resources.md)

## Other useful resources

1. [MarsBased website](https://marsbased.com)
2. [MarsBased blog](https://marsbased.com/blog)
3. [Life on Mars - The MarsBased Podcast, English Edition](https://podcast.marsbased.com/)
4. [Life on Mars - The MarsBased Podcast, Spanish Edition](https://podcast.marsbased.com/podcasts-es/)
5. [MarsBased newsletter](https://marsbased.us7.list-manage.com/subscribe/post?u=1ab50c539712be36367b96b98\&id=89db0a6312)
6. [MarsBased YouTube channel](https://www.youtube.com/@MarsBased)

## Contributing

We encourage you to contribute! Please check out the [Contributing guides](https://github.com/MarsBased/handbook/blob/main/CONTRIBUTING.md) for guidelines about how to proceed. ​


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://handbook.marsbased.com/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
