ייצוא קוד מ-Base44 ל-GitHub: מה באמת מקבלים, ומה כבר לא הפיך

למה בכלל לייצא

שלוש סיבות מובילות אנשים לחפש את זה, והן דורשות דברים שונים.

רוצים גיבוי של הקוד מחוץ לפלטפורמה - החיבור ל-GitHub עונה על זה במלואו. רוצים לעבוד עם מפתח או צוות - גם כאן החיבור עונה, ומוסיף עבודה מקומית ו-pull requests. רוצים לצאת מהפלטפורמה - כאן החיבור הוא רק הצעד הראשון מתוך כמה. פירוט בהמשך.

איך זה עובד, לפי התיעוד הרשמי

התהליך שמתועד במסמכי הפיתוח של Base44:

1. בדשבורד של האפליקציה, לחיצה על אייקון GitHub ואז Connect to GitHub
2. אישור של Base44 Builder ובחירה לאילו ארגונים או מאגרים לתת גישה
3. יצירת מאגר חדש עבור האפליקציה
4. clone של המאגר למחשב המקומי
5. npm install, והגדרת .env.local עם מזהה האפליקציה וכתובת ה-backend
6. npm run dev להרצה מקומית

מכאן הסנכרון דו-כיווני ואוטומטי: שינויים שנעשים ב-Base44 מסונכרנים ל-GitHub, ושינויים שמוזגו לענף main מסונכרנים בחזרה. אין אפשרות לדחוף ידנית מ-Base44 ל-GitHub - הכל אוטומטי.

דרישת תוכנית: לפי התיעוד, סנכרון דו-כיווני עם GitHub דורש תוכנית Builder ומעלה.

ארבע המגבלות שכדאי להכיר לפני הלחיצה

זה החלק שנוטה להיקבר בסוף מדריכים, והוא בדיוק החלק שמשנה החלטות. כל אחת מהנקודות מופיעה בתיעוד של Base44 עצמה.

1. החיבור קבוע

"GitHub sync is permanent. You can't disconnect or transfer the project back to Base44." אי אפשר לנתק ולהחזיר את הפרויקט לניהול מלא של הפלטפורמה. זו החלטה חד-כיוונית.

2. היסטוריית הגרסאות שלפני החיבור הופכת ללא זמינה

אחרי החיבור לא ניתן להשתמש ב-Version History כדי לחזור לגרסאות שקדמו לו. אתם מחליפים את רשת הביטחון המובנית של הפלטפורמה בהיסטוריית git. אם עוד לא קראתם על מה Version History כן ולא משחזרת, זה מוסבר במדריך התקלות והשחזור.

3. רק ענף main

הענף master אינו נתמך. אם אתם מייבאים הרגלים מפרויקט ישן, זה שווה בדיקה מראש.

4. אין דרך חזרה לאותו מאגר

אחרי ניתוק, לא ניתן להתחבר שוב לאותו מאגר.

מה שהחיבור נותן, ומה שהוא לא

זו הנקודה שהכי מבלבלת, ושווה לומר אותה בפשטות.

החיבור ל-GitHub נותן לכם את קוד האפליקציה. מאגר שאתם שולטים בו, היסטוריית שינויים, יכולת לעבוד מקומית ולצרף מפתחים.

הוא לא מנתק אתכם מהפלטפורמה. קובץ ה-.env.local מצביע על ה-backend של Base44 - כלומר האפליקציה שרצה אצלכם מקומית עדיין מדברת מול השרתים שלהם. מסד הנתונים, ההרשאות, הפונקציות והאימות נשארים שם.

לכן, אם המטרה היא באמת עצמאות, יש שני שלבים ולא אחד:

1. ייצוא הקוד - מה שהמדריך הזה מתאר
2. העברת התשתית - מסד הנתונים, מדיניות ה-RLS, פונקציות ה-backend והאימות. זה פרויקט בפני עצמו, ותיארנו אותו במדריך המעבר מ-Base44 ל-Supabase

מי שמדלג על ההבחנה הזו מגלה אותה באמצע, בדרך כלל אחרי שכבר הודיע למישהו שהמעבר הושלם.

צ'קליסט לפני שמחברים

• יש לי תוכנית Builder ומעלה - אחרת הסנכרון הדו-כיווני לא זמין
• בדקתי אם אני צריך גרסה שקדמה להיום - אחרי החיבור לא אוכל לחזור אליה דרך Version History
• המאגר שאני יוצר הוא זה שאני רוצה לטווח ארוך - אין חזרה לאותו מאגר אחרי ניתוק
• הענף הוא main
• יש לי גיבוי של הנתונים, לא רק של הקוד - הייצוא לא נוגע בתוכן שמשתמשים הזינו
• בדקתי RLS לפני שהקוד יוצא החוצה - קוד במאגר פרטי הוא עדיין קוד שיותר אנשים רואים. הרצת Start security check תחת Security בדשבורד היא הצעד הזול ביותר כאן, ומדריך RLS מפרט את השאר
• אין מפתחות בקוד - ובמיוחד לא service_role. ראו מדריך האבטחה

שאלות נפוצות

איך מייצאים קוד מ-Base44 ל-GitHub?

בדשבורד של האפליקציה לוחצים על אייקון GitHub ואז Connect to GitHub, מאשרים את Base44 Builder ובוחרים לאילו ארגונים או מאגרים לתת גישה, יוצרים מאגר חדש לאפליקציה, ואז מבצעים clone מקומי, מריצים npm install, מגדירים .env.local עם מזהה האפליקציה וכתובת ה-backend, ומריצים npm run dev. הסנכרון מכאן ואילך אוטומטי בשני הכיוונים.

האם אפשר לנתק את GitHub ולחזור אחורה?

לא. התיעוד של Base44 קובע במפורש שהסנכרון עם GitHub הוא קבוע, שלא ניתן לנתק או להעביר את הפרויקט בחזרה ל-Base44, ושאחרי ניתוק אי אפשר להתחבר שוב לאותו מאגר. זו החלטה חד-כיוונית ולכן כדאי לקבל אותה במודע.

מה קורה להיסטוריית הגרסאות אחרי החיבור?

לפי התיעוד, אחרי חיבור GitHub לא ניתן להשתמש ב-Version History כדי לחזור לגרסאות שקדמו לחיבור. במילים אחרות, אתם מחליפים את מנגנון השחזור המובנה של הפלטפורמה בהיסטוריית git. זו לא בהכרח החלפה גרועה, אבל היא כן החלפה - ולא תוספת.

איזו תוכנית נדרשת לסנכרון עם GitHub?

לפי התיעוד של Base44, סנכרון דו-כיווני עם GitHub דורש תוכנית Builder ומעלה.

ייצוא ל-GitHub זה כמו מעבר ל-Supabase?

לא. ייצוא ל-GitHub נותן לכם את קוד האפליקציה במאגר שאתם שולטים בו, אבל האפליקציה עדיין רצה מול ה-backend של Base44 - קובץ ה-.env.local מצביע עליו. מעבר מלא לתשתית עצמאית הוא פרויקט נפרד שכולל גם את מסד הנתונים, ההרשאות והפונקציות.

מקורות

• Base44 - GitHub Integration - התיעוד הרשמי שממנו נלקחו שלבי ההתקנה, דרישת התוכנית וארבע המגבלות
• Base44 - Troubleshooting

שוקלים לייצא ולא בטוחים אם זה גיבוי או תחילת מעבר? דברו איתנו בוואטסאפ - נעבור על הצ'קליסט למעלה יחד לפני שתלחצו על Connect.