diff --git a/docs/src/components/Header/LanguageSelect.tsx b/docs/src/components/Header/LanguageSelect.tsx
index 815bef472..a5fb73f78 100644
--- a/docs/src/components/Header/LanguageSelect.tsx
+++ b/docs/src/components/Header/LanguageSelect.tsx
@@ -70,6 +70,9 @@ const LanguageSelect: FunctionalComponent<{ lang: string }> = ({ lang }) => {
+
);
diff --git a/docs/src/config.ts b/docs/src/config.ts
index 2ff25dd90..b66dc9d01 100644
--- a/docs/src/config.ts
+++ b/docs/src/config.ts
@@ -65,6 +65,10 @@ export const SIDEBAR = {
{ text: '安裝', link: 'zh-TW/installation' },
{ text: '範例', link: 'zh-TW/examples' },
],
+ bg: [
+ { text: 'Главни', header: true },
+ { text: 'Започваме!', link: 'bg/getting-started' }
+ ]
};
export const SITE = {
diff --git a/docs/src/pages/bg/getting-started.md b/docs/src/pages/bg/getting-started.md
new file mode 100644
index 000000000..f34dfa85c
--- /dev/null
+++ b/docs/src/pages/bg/getting-started.md
@@ -0,0 +1,62 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Започваме!
+---
+
+Astro е модерен builder за статични сайтове. Научете всичко за Astro от [нашата начална страница](https://astro.build/) или от [release поста](https://astro.build/blog/introducing-astro). Тази страница е оглед на документацията на Astro и всички свързани ресурси.
+
+За бърз оглед на Astro, посетете нашата [начална страница](https://astro.build).
+
+## Пробвайте Astro
+
+Най-лесният начин да пробвате Astro е да изпълните `npm init astro` в нова локална директория. Нашият CLI Wizard ще Ви помогне да започнете нов Astro проект.
+
+За да започнете с Astro в 5 бързи и лесни стъпки, посетете нашия [Гид за бърз старт](quick-start).
+
+Алтернативно, можете да прочетете нашия [Инсталационен гид](/installation) за всичко относно настройката на Astro.
+
+### Онлайн площадки (playgrounds)
+
+Ако искате да си експериментирате с Astro в браузъра, можете да използвате онлайн площадка за код. Пробвайте нашия "Hello World!" темплейт на [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3).
+
+_Бележка: някои функционалности (например: Fast Refresh) са лимитирани на CodeSandbox засега._
+
+## Научете Astro
+
+Всякакви видове хора с различни методи за обучение се ориентират към Astro. Независимо дали предпочитате по-теоретичен, или по-практически подход, ние се надяваме че ще намерите тази секция за полезна.
+
+- Ако предпочитате да **учите чрез практика**, започнете с нашата [библиотека с примери](https://github.com/snowpackjs/astro/tree/main/examples).
+- Ако предпочитате да **учите концепции стъпка по стъпка**, започнете с нашите [базови концепции и гидове](/core-concepts/project-structure).
+
+Като всяка непозната технология, Astro изисква известно време, за да се научи. Но с практика и малко търпение, ние сме сигурни, че _ще го схванете_ за нула време.
+
+### Научете `.astro` синтаксис
+
+Когато започнете да учите Astro, ще видите много файлове с разширение `.astro`. Това е **Компонентният синтаксис на Astro** -
+специален файлов формат наподобяващ HTML, който Astro използва за изграждане на страници (templating). Направен е, така че да е познат на всеки с HTML или JSX опит.
+
+Нашият помощен гид за [Astro компонентите](/core-concepts/astro-components) Ви запознава със синтаксисът на Astro и е най-добрият начин да се научите.
+
+### API Справка
+
+Тази секция е полезна, когато искате да научите повече детайли относно даден Astro API. Например - [Конфигурационната справка](/reference/configuration-reference) изброява всички възможни конфигурационни опции. [Справката за вградени компоненти](/reference/builtin-components) изброява всички възможни базови (core) компоненти, като `` и ``.
+
+### Версия на документацията
+
+Тази документация винаги рефлектира последната стабилна версия на Astro. Когато пуснем версия 1.0, ще добавим опция за преглед на предишни или бъдещи версии.
+
+## Бъдете информирани
+
+Официалният източник за новини от екипа на Astro е Twitter акаунтът - [@astrodotbuild](https://twitter.com/astrodotbuild).
+
+Публикуваме и съобщения относно нови версии в [нашия Discord сървър](https://astro.build/chat) в #announcements канала.
+
+Не всяка нова версия на Astro заслужава собствен блог пост, но можете да намерите регистър на промените за всеки релийз в [`CHANGELOG.MD` файла, намиращ се в репото на Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
+
+## Нещо липсва?
+
+Ако нещо липсва в документацията или намирате нещо за объркващо, моля [подайте го като issue за документацията](https://github.com/snowpackjs/astro/issues/new/choose) с Вашите предложения за подобрение или пуснете tweet към [@astrodotbuild](https://twitter.com/astrodotbuild). Обичаме да чуваме от Вас!
+
+## Credit
+
+Първоначално този гид е базиран на документацията на [React](https://reactjs.org/).
diff --git a/docs/src/pages/index.astro b/docs/src/pages/index.astro
index 2b090ca81..eaa67e524 100644
--- a/docs/src/pages/index.astro
+++ b/docs/src/pages/index.astro
@@ -6,7 +6,7 @@ import Layout from '../layouts/MainLayout.astro';
// This is some wip redirect code based on the browser language.
// A vercel.json redirect is enforced in production, so no user should ever see this page.
// Remove the vercel.json redirect when this is ready.
- const KNOWN_LANGUAGES = ['de','en','es','fi','nl','pt-br','zh-CN','zh-TW'];
+ const KNOWN_LANGUAGES = ['bg', 'de','en','es','fi','nl','pt-br','zh-CN','zh-TW'];
let newLangWithRegion = (window.navigator.userLanguage || window.navigator.language || 'en-US').substr(0, 5);
let newLang = newLangWithRegion.substr(0, 2);
if (newLang === 'en') {
@@ -18,4 +18,4 @@ import Layout from '../layouts/MainLayout.astro';
} else {
window.location.pathname = '/getting-started';
}
-
\ No newline at end of file
+